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INTRODUCTION 


Eurrcugh*s Computer Management Systerw Generalized Message Control 
System CCMS GEMCOS) ts an environmental software product providing 
on-line network support to users of Burroughs CMS computers. CMS 
GEMCCS provides fast» efficient and flexible management of both termi- 
nals anc programs alike» and altows the network to grow with its user's 
tusiness processing needs. 


Capatilities provided ty CMS GEMCOS cover a broad range of eOmeye nd 
requirements» and include the foilowing features: 


ae Message routing. 

be Transacticn control. 

ce Distributed processing. 

d. Concentration. 

@. Audit and recovery. 

f.~ Terwinal formatting. 

ge Interprogram communication. 
he. Access control. 

ie Network ccntrot. 

je Program ccntrol. 

k. Error reporting. 

{. Pre-compiied instatlation. 
me. Custom code generation. 

ne. Network reconfiguration and management. 


CMS GEMCOS is available on ail purroughs CMS coaputers under the ; 
foltowing style identifications: CM8O GMC (for BBO systems) CM90 GMC 
(for B9G systems) and CMEOC GMC Cfor Beoc systeas). 


For cocumentation relarine to C5 GEMCES and on-line processing» refer 
to the following publications: ; 


ae CMS GEMCOS Program Product Specifications form 1108503. 
be CHS. GEMCOS Capabilities Manual» fora 1106614. 
co CMS Format Generator User's Guide» form 1114634. 


ay 


de CHS’ CL)» form 1124740. 


ee CMS TOS Reference Manual» form 110516C. 


¥. jcMuS.cOBOL Reference Manual» form 2007266. 


2007563. 


he CMS Network Definition Language (NDL) Reference Maadeds form 
1090925. 


SECTION 1 


SYSTEM OVERVIEW 


A system overview cf the Computer Management System Senemalteee 
Message Controt System (CMS GEMCOS) is presented in this section. 


GENEFATIVE FEATURES. | : 
In CHS GEMCOS» system installation is a two-fotd operation. First» the > 
features of the network must be selecteds and seconds these features 

gust be incorporated into a Message Control System (MCS). The language | 
used to descrite the network is calted the Transaction Control Language , 
(TCL). The program which translates TCL is catled the ICL compiler or  [@@ 


Message Control System (HCS) generator. 


TRANSACTION CONTROL LANGUAGE. 
TCL is a highwtlevet tanguage which seeeraues an on-line network and is 
common to the family of GEMCOS MCSs. ICL attows for fast and effictant 


definition of a wice range of processing environments. 


TCL is a free-form language tn which famitiar words and phrases are 
used to descrite a user network. Each TCL statement describes some 
portion of an on-line system: the users» the programs» the stations 
cr the MCS. By compiling these incividual statements» the MCS 
generator is able to create an MCS to control the desired environment . | @ 


ROUTING. 
The primary purpose of an *¥CS is to manage message routing. It 1s the 
responsibslity of the MCS to provide the link between both program and 
gstation - and progr aa and programs as well as between individual stations 

an the network. rn CMS GEMCOS there are three different. types of F 
routing: transaction-based routings fixed-assignment routing and 
concentration. ae ; - 


Transaction- based routing atlows the destination of a message to be 
cetermined by its contents. Transaction codes are associated with pro- 
grams in TCL and are input by an operator or a program as part of 

the wessage text. 3y examining a transaction code» the MCS can 
identify it with a program and route the message to the programs. 


Fixed assignment routing allows a station Coperators programs SPO» or 
disk file) to te assigned to a particular application. Until the 
assicnment is revoked» the MCS continues to route messages to the 
specified program. 


Concentration is the process of gathering messages from low-speed lines 
and retransmitting them to another computer over faster Lines. CMS 
GEMCCS atlows a CMS computer to operate as a concentrator to another 
system in either transparent mode (where the concentrator appears as an 
ordinary station tec the host?) or tn GEMCOS mode (where CMS GEMCOS 
utilizes a special B 7€9C/B 6000 GEMCOS protocol which aliltows the large 
system host to send messages tack to the CMS GEMCOS network). | 
Concentration allows the C¥S computer to operate as a distrivuted 
network manager anc to lower processor overhead line costs to the host. 


ACCESS CONTROL. |” 


CMS GEMCOUS allows access control at four separate levels: by users by 
stations by program and by transaction. Users may be required to sign-. 
on before beginning to work. These users may then be restricted as to 
where they may sign ons which programs they may assign and which trans- 
actions they may enter. Working together» these controls timit access 
to. every portion of the system. | | 


NETWORK MANAGEMENT. 

In order to adapt to ongoing network syandese CMS GEMCOS attows 
users to modify selected network attributes at run time. Employing 
CMS GEMCOS Network Control Commands (NCC*s)» users at designated 
stations may perform such diverse functions as dynamically reconfiguring 
the networks making a station ready or not ready» obtaining network: 
status and condition reports» and sending administrative broadcast 
messagese These and other commands help make CMS GEMCOS an excep: 
tionally powerful and flexible system for managing message routing and 
maintaining the network. 


~~ ALTERNATE ROUTING.» 

CMS GEMCOS atlows users to provide for hardware failures through a 
feature called aiternate routing. Through ICL descriptions» users say 
preprogram the NCS to automatically compensate for network aat functions 
by sending asaessages destined for inoperable stations to alternates 
usabie ones. If the alternate stations are down» CMS GEMCOS saves 
their messages on disk until the stations are in working order again. 


‘(INIERPROGRAN COMMUNICATION. 

ll In order to allow comaunications between application programs» CMS 

i) GEMCOS supports an Inter program Communication CIPC) capability. Using 
SIPC» programs can communicate with one another without the overhead of 
Bfites or the Input/Output (1/0) subsystea. 


FQORMATIING: 

In order to free the application froa davies dependency and redundant 
programming» CMS GEMCOS supports a terminal formatting capability. 
Using the CMS Format Generator» users may define message pictures which 
describe how tndividual messages are disptayed. Refer to the C¥S Format 
Generator User’s Guide» form 1114634. 


APPLICATIONS PROGRAM INTERFACE. 

CMS GEMCOS is able to interface with programs written in CMS COBOL 

or MPL<“II. Refer to the CMS COBOL Refererce Manual» form 2007266 and 
the CMS Message Processing Language (MPL“II) Reference Manual» fora 
2007563. . | 


SWITCHED LINES. 

CMS GEMCOS suposoorts switched lines. It provides for. automatic dialing 
and disconnecting on outgotng calls using the Network Control Conaands 
DIALOUT and DISCONNECT. Refer to the DIALOUT and DISCONNECT comsands 
in section @. Users may also manually dial and disconnect outgoing and 


Incoming catls. 


As connections are made» the stations comprising the remote site are 
automatically attached to the line by the MCS. The MCS uses the 
SITEDIRECTORY FILE which contains descriptions of each site tn t2rms 
of their station name lists and their line attributes. [his directory 
as built at system initialization after configuration of the netaork 
is completed. It may be updated at any time using the CONF Network 
Control Command. Fafer to the CONF command tn section 8. © 


Remote sites that are not in the directory may also calt in or te 
calted but the user must attach the stations to the Line. This ts done 
using the RS (Redefine Station) command. Refer to the RS comand in 
section & The tine number of each station in the Site is enanges to 
the number of the fine to be used. 


| NOTE 
The tine number reiting changed may not 
be changed to a Line number that 15 
already in the directory. 


In order to avoid changing line numbers» new sites should be ima2- 
diately added to the SITEDIRECTORYFILE using the CONF coammand. 


NOTE 
A modem that offers diatout» using an 
Automatic Catt Unit CACU) shoutd not te 
defined as dialout capable CBITXX in the 
TYPE fietd) even though the Line is. 
This tS Cecause the ACU performs the 
dialing. For examples the BELL 202C 
DATA SET should have a TYPE fietd of 
MOOBAA not AGOIAD.»” This tndicates 
MODEM CONNECT» OITALIN CAPABLE and 
ASY CHREGNOUS. 


Multiple dialouts on a tine to the same site are permitted. 


ae 


SECTION 2 


SYSTEM NGTATION 


BASIC SYMBOLS. 


The t-asic syntax elements used in this manuat are described in the 
following table. | 


Syntax | Description 


<access keys> Access keys are identifiers used to 

| 3 establish an operator's access rights. 
Access keys cannot be tonger than 16 
characters» and must be surrounded by 
quotes if they contain special 
characters.e 


"MY ACCESSKEY 
MYACCESSKEY 


<comma lists> Comma tists are sequences of otjects 
separated by commas. 


STATIQN1» STATION2» STATION? 


<file names> , File names are CMS disk file names and — 
| may reference toth a volume and a file. 


MYFACK/MYFILE 
<integers> Integers are unsigned numbers between G 
and 65535. Integers may contain leading 
zeroes» but cannot be tonger than five 
digits. 


0123 
123 


<lists> Lists are sequences of one or aore 
otjyects in succession. 


STATIONI STATION2 STATIONS 


<logical vatues> Logical vatues must be TRUE or FALSE. 


2-1 


ayntax 


<passwords> 


<program names> 


<queue names> 


<station names> 


<station families>. 


<strings> 


<trancodes> 


22 


Passwords are security keys used to 
verify an operator's identity. Passwords 
cannot be tonger than 15 charaeters and 
must te surrounded by quotes if they 
contain speciat characters. 


"MY.PASSWORD* 
MYPASSWORD 


Program names are identifiers which refer 
to applications programs. Program names 
must not exceed 12 characters. 


MYPROGNAME 


Queue names are NOL file identifiers and 


refer to the subnet. queue used by a 


prograa for datacom input. 
NDLFILEIO 


Station names are NDL logical stistion 
names» and refer to stations in the | 
network. 


NDLSTATIONID 


Station families specify multiple station 
names beginning with the same characters 
or a single station name. 


TD&3C= 
STATION= 
TDOB30XA 


Strings are sequences of characters 
surrounded by quotes. Strings may con- 
tain from 0 to 255 characters ang cannot 
contain the quote character itself. 
Strings may be continued from one line to 
another. 


"THIS IS A STRING" 
Trancodes are program transaction codes 
which are typed in by an operator. Tran 


codes cannot te tonger than 16 characters. 


TRANCGCE 


SECTION 3 


SYSTEM FILES 


cms GENcos utilizes 16 permanent disk files for MCS 


La 16 generations 
compilation and sgaintenance. 


COMPILATION FILESs 


ts created by the TCL compiler whenever full generation 
1s requested. NCSCODE is the compilable MCS source file. 


| $ the MCS Object file» and aay be executed foltioning a 
essful TCL coapilation. MCSOBJ is supplied with each release. 


s used by the MPL-IT compiler for program segmentation 


and describes the segmentation of CMS GEMCOS. MCSEGMENT is 
supplied with each release. 


is the source code for CMS GEMCOS» and is supplied with 
each release. i : 


EXECUTION FILES: 


= 


| J s created by the MCS whenever audit 1s requested and 
contains all messages audited by CMS GEMCOS. [t is used during 
recovery in the event of a system routes ee | 


s_ used by the MCS to produce di agnostic messa 
wcoontains all output messages which. the MCS general es 
jis supplied with each release. 


STTENIF is the MCS Site Network Information File, and is created. 
Piduring a datacos warm=start by entering a configuration statement ._ 
it _descrites the physical datacom « aracteristics of a user's site. 


Fis the MCS Output Control Commands file. This file 


lcontains Network Control poseands and the MCS responses to the 
| commands. 


: s the MCS Control/Error Log file» and contains atl 
error messages» fetch value errors» and control messages. 
eo 


‘4 OG? is the MCS Event Log filer and contains all messages 
jpr ocessed by the MCS. | ence ana 


Bm penesattente 
. RRMA MITOSIS scat 


ERC RRA EES IE CODERS 


MCSFMT is the MCS Format files and contains compiled terminat 
formats. MCSFMT is created by the CMS Format Generator. 


MCSITEDIPFILE and MCSITEDIRDATA are tndexed files specifying the 
disk and file name of the the MCS site directory. The contents of 
the fites are established during a datacom warmastart when a user 
requests to build the directory descriting the user's remote sites. 
MCSITEDIRDATA is the file containing the actuat site numbers and 

MCSITEDIRFILE ts the associated key file. 


MCSPHONEDIRF ILE and MCSPHONEDIRDATA are indexed files specif ying 
the disk and file name of the “CS phone directory. The contents 
of the files are established during a datacom warmstart when a 
user requests to buitd the directory describing the user's remote 
sites. MCSPHONEDIRDATA is the file containing the actual phone 
numbers and the MCSPHONEDIRFILE 1s the associated key file. 


¥s an inwtransit storage file for undeliverable messages» 
is created by GEMCOS whenever the MCS is cotd-st arted. 


MC: fis used by the MCS to describe the user network. It may 
be ‘created by the TCL compiter after an error~free compitation»s or 
by GEMCOS during initialization. 


as “cemmiacmmuae 


OL S00€ is the CMS GEMCOS release information document» and 
‘poescribes changes made to the. previous release. 


PHMCSNDL is a sample NDL source program which runs with CMS 
(IGEMCOS. It is intended to be an example of the MCS/NDL interfaces 
mifand 4s supplied with each release. 


SECTION 4 


SYSTEM UTILITIES 


_ The CMS GEMCOS release package includes three stand-alone utilities for 
system maintenance and diagnosis: MCSFIX» MCSDUMP.» AND MCSMERGE> 

and a fourth utility» MCSZIP» for implementation of the ZIP Network 
Control Cogmand. 

» | | 
CSFIX is a program designed to update the MNCS Source fite (MCSOURCE ) 
Should release patches ever be issued. MCSFIX works similarty to the. 
MPL compiler» using $"records and sequence numbers to manipulate the 
file. Shouid patches ever become necessary for CMS GEMCOS» they are 
issued with comptiete instructions for their application using MCSFIX. 


MCSDUMP is a program desiqned to interpret the MCS audit» tank and 
warma-start files» and to produce a listine of their contents: 


_—— EX ———MCSDUMP A Zo Vestal ec ge 
: - T 4 
| : W | 


If A is specified» an audit-file listing is produced. If Tor W 
is specified» a tank or warm-start file listing is produced. 


MCSMERGE is a program designed to combine two separate GEMCOS warm-start 
files into one: 


— MCSMERGE ————-——. <file-name >. a ea ees < file-name > 


The resulting file replaces the file named first. Where differences are 
detected between descriptions of the same object» the description in 
the first file takes precedence. 


MCSZIP ts a@ MCS utility program. It may rot te executed directly by a 
user. If the ZIP command 1s entered» the MCS executes MCSZIP to | 
initiate the specified user program. fhe MCS continues to run while . 
MCSZIP waits for the program to finish. khen the program is completed>, 
MCSZIP sends this information back to the MCS. 


SECTION 5 


PROGRAM INTERFACE 


GENERAL. 
\To write a program which interfaces with CMS GEMCOS the. programmer must 
eatures ard ligitations of this S! ‘stems. 


ibe familiar with the interface 
rns section explains the considerations to be made _and presents “simple _ 


jprograns as examp CSe 
stapes 0 ENESCO LOE OC TIED 


FEATURES» | 
A program which interfaces with CMS GEMCOS remains independent from the 
CMS GEMCSOS network. To facilitate program interface the MCS provides 

the necessary subnet queue names (NDL files) and station names while 

the interface program is running. In addition to the normal GEMCOS — 
interfaces the MCS provides alternative IMCS (Transaction Message Control 
Systea) interface capabilities in both unshifted and shifted formats. 

The selection of the interface type is made using the Transaction Control 
TMCS interface is discussed at the end of this section. | 


Language. 


GPEN and St er temenee need arr 


ba eaotredety specified. | 
A system of dummy stations is utilized by the MCS. This system enables’ 
ith t » the SPO» the Control Command Soe. 


rams without an Tt 


.brograas to interfac 


they correspond to the following GUeaents 


oS Inst ead» 
In ae Det eorre 


. NCS (named MCS). 


SPO (named DO). 


TIEN EI Ai 
ce 
ea RR at ec Hem ERA ROC 
“thse 
Wedron 


Controt Command file (naned cod. | 
have <n> repecachia a err 


\ ee dther programs ‘(names MX<n>> 
' left- justified). 
stations are intercepted OY. 


l| Messages sent to dummy ‘the MCS and_ . 


‘l[gelivered to the appropriate. destinatic 


“A aessage passed between the program and dumay station NCS _is_prefixed 


erie ait te aaa de 


Terre 


ae 


~ Descriptions 


MCN TONRSEE 


si ‘SPERM RVR RGR EAN NAR DESIRE. 


aM 


PETC Eee 


a1 


Field 


PRACTICE MODE FLAG 
TRANSACTION DATA 1 
TRANSACTION DATA 2 
STATION DATA 

HALT FLAG 

RECOVERY FLAG 
CONTINUE FLAG 
SEGUENCE NUMBER 


SROADCAST FLAG 
FORMAT REQUEST FLAG 


INTERNAL FORMAT FLAG 
DELAYED MESSAGE FLAG 
LOGON MESSAGE FLAG 
LOGOFF MESSAGE FLAG 
ENABLED QUEUE CEG) FLAG 
ATTACHED QUEUE CAQ) FLAG 
TASK DETACHED FLAG 
VACANT ELAG 
TRANCODE FLAG 
MODULAR FLAG 
Creserved) 


PRACTICE FLAG. 
This flag is set by the MCS to 
station sending the message. 


 Lengt 
in 
Bytes 


1 
5 
3 
5 
1 
1 
1 
lf 
i 
1 
1 
1 
i 


h 


oe ol ee 


indicate the operating mode of the 


The flag 


1s set 


to the value 1 for 


practice mode and to the vatue 0 (zero) for normat mode. 


TRANSACTION DATA 1 AND 2. 


These tields are used by the MCS during transaction-based routing to 


pass to the program any constants» 


codee for examples 


associated 


if transaction code *XY¥Z" were defined 
Transaction Control Language as "TRANCODE 


XY¥ZC12%354).">» 


with the transaction 
in 
TRANSACTION 


DATA 1 and 2 fields will be set to the values 00012 and 00034» respec- 


tively,» 
transaction=based routing 


STATION DATA. 


for all sutsequent XYZ transactions. 
specified» each field has the value 690000. 


If 


If no constants are 
routing other than 


is used» both fields are set to spaces. 


This field is used by the MCS for messages originating from a station 
to forward the optional STATIONDATA constant» 
in Transaction Controt tanguage. 


defined in TCL as "STATIONDATA 


subsequent message from "*TD&3S0XKA" 


For examples 
99", the STAT 
is set to th 


detined for that station 
if station "TD&30XA™ is 
ION DATA field tn each 

e value 00099. 


HALT FLAG. 

This fietd is set ty the MCS to the value 1 to inform a programs when a 
HALT» STOP» or TERMINATE Network Control Command has been perforaed; 
the program ts unatte to determine which command was used. Refer to 
the NETWORK CONTROL COMMANDS section for descriptions of these three 
commandse The HALT flag message consists of the header only. 


RECOVERY FLAG. 

This field is set ty the MCS to indicate the processing mode of the | 
network. A value of 1 in this field indicates this is recovery mode. 
and that the accompanying message originates from the audit file. 

A value of 0 (zero) indicates normat mode. | 


CONTINUE FLAG. 

This field is set ty a program to acknowledge receipt of a recovered 
messagee After reading a message from the audit fite» the MCS sends 
the message to the program and sends no addittonat messages from the 
audit file until the program returns a message consisting of a header 
in which the CONTINUE flag is set to the value 1. 


SEQUENCE NUMBER. 7 | 

This field is the sequence number assigned by the MCS to every message 
it audits and is used ty the MCS in RECOVERY mode to pass the sequence 
numter of a message to a program. Messages not being audited sre 
assigned a sequence number which is set to spaces. The sequence nuaber 
consists of two parts: the first is the 2-digit file numbers the 
second is the S-digit togical record -numter within the file. The 
number of togicat records per file is specified in Transaction Control 
Language. The file number is reset to the value 0 (zero) after 100 
audit files are filleds the logical record number is reset to the value 
@ (zero) at the beginning of a new audit file. Refer to the AUDIT/ 
RECOVERY sectton for a more detatted description, 


eat 


pa lcneeshene een | “t he sat taching 
TES TTT LE acocseskey. Cor spaces if: SIGNON = 
FALSE in the station section in TCL» or no user is signed on at the 
station» or if the message origin was a program) comprise the £8 bytes 
which immediately follow the MCS header. The remainder of the message 
consists of optional text. 


CLOSE FLAG. 


This field is set ty the MCS to the value 1 in a seseage inferming a 
program that one of the assigned stations has been detached by a CLOSE 
or DETACH CDT) command. The name of the station formerly assigned to 
the program aupeers in the 12 bytes immediately following the ¥CS 
header. 


BROADCAST FLAG. | , 
This fietd is set bty the MCS to the value 1 in any message which 

is sent using the SEND Network Controt Command. The name of the station 
or dummy station sending the message appears in the 12 bytes immediately 
following the MCS header. The message text follows the name of the 
sender. | 


FORMAT REQUEST FLAG. 

This field is set ty a program to the value 1 in any message requiring 
output formatting. The first 12 bytes foliowing the header contain the 
destination of the messagee The next 12 bytes contain the name of the 
requested format. Message text follows the format name. The message 
as sent to the MCS (1.@-e» to dummy station MCS). 


FORMAT ERROR FLAG. 
This field is set ty the MCS to identify an erroneous input formatted 
message from a station. The format of this message is as foltows: 


ae Name of the station (12 bytes). 

b. Name of the input format (12 bytes). 

c. Error number (3 bytes). — 

de Location of the character causing the error (5 cytes). 
e. Wessage (formatted as wett as possible). 


| NOTE 
The error tocation is zero relative. 


INTERNAL FORMAT FLAG. 

This field is set by a program when a Network Control Command 3s sent 
to the MCS. A value of 1 in this fietd informs the MCS that alt 
responses to the command must be sent in internal format. With the 
value 0 (zero)» this flag informs the MCS that alt responses to a 
command wilt be sent tn external format. 


DELAYED MESSAGE FLAG. 

The fiag for this message type is set to the vatue 1 to inform the 
receiver that the message accompanying this flag is a del ayed response 
to an earlier Network Controt Command. Delayed messages are formatted 
one of two ways: internally or externally. The format of the message 
is established by the receiver. : | | 


LOGON MESSAGE FLAG. 

This fietd is set ty the MCS to the value 1 to identify a Loy-on mess 
sage. The MCS header is foltowed immediatety ty the 12-byte station 
name and the 16*byte access key entered with the LOGON Network Control 
Command. 


LOGOFF MESSAGE FLAG. 

This fieid is set by the MCS to the value i to identify a ltogj-off mes- 
sages The MCS header is followed tamediately by the 12*byte station 
name of the statior togging off. This message may be sent as a resutt 
of a LOGOFF Network Controt Commana or a station failure. 


ENABLED QUEUE (CEQ) FLAG. | 

This fietd ts set ty the MCS when one program has tnitiated or attached 
another program. The MCS sets the flag in the message to informa the 
oritcinating program that a subnet queue has been allocated to the 
initiated or attached program. The 12 bytes following the MCS header 
provide the dummy station name associated with the initiated program. 


ATTACHED QUEUE CAQ) FLAG. 7 
This field is set Ly the MCS when one program has executed or attached 
another program. The MCS sets the flag in the message to infora the 
originating program that the initiated or attached program has performed 
a RECEIVE on the aliocated subnet queue. The 12 bytes following the 

MCS header provide the dummy station name associated with the initiated 
program. 


TASK DETACHED FLAG. 

This field ts used by the MCS. when a program attached by. another prograan 
proceeds to End-of-Job (E0J). The MCS sets this flag to the value 1 in 

messages which inform each attached program of the termination. The 

12 bytes fotlowing the header provide the dummy station name esatelatcd 

with the terminated program. | 


VACANT FLAG. 

This field is used by the MCS to inform a program that the tast station 
attached to it has been detached or closed. fTherefores no stations are 
attached to the sutnet queue. Thus» it may be preferable to establish — 
a convention where» upon receipt of a VACANT message» the progras 
proceeds to EnderofeJob CEOJ). 


372 


TRANCODE FLAG. | 

This fiag is set to 1 by a program requesting comaunication with another 
program via trancode routing. The MCS header should be foilowed by the 
transaction code of the program that it is betng sent to. 


MODULAR FLAG. | | 

This flag may be set by the MCS or a program. After receiving a message 
from an MT600 terminal the MCS sets the MODULAR@*FLAG to the value in 

the middle byte of the special MT60G6 header. Refer to section 12 
TERMINALS AND PRINTERS. The message ts then routed or processed 
accordingly. <A participating program may send a message to an M¥6C0 
terminal by setting the MODULAR-FLAG to a value that represents the 
middle byte of the spectat MT600 header. The MCS uses this value to 
build the MT600 header then routes the message to the MT600. 


MODULAR TRAILER FLAG. 

This flag may be set» by a programs to send a message with a tragler to 
an M1600 tersinat. GEMNCOS appends an appropriate MT600 trailer to the 
gsessagee The MODULAR FLAG must also be set when using this flag. 


CHANGING THE MCS HEADER SIZEs | 

It is possibte to increase the size of the MCS header above 50 bytes. 
This increase allows additional user data to be passed. The header 
size is controlled by the TCL attributes» HEADERSIZE. If the attribute 
HEADERSIZE is used» atl programs in the network receive the extended 
header. Speciat usercode may be added by means of user hooks to 
utilize the additional header space created. Briefly» user hooks refer 
to areas within the source code that can accommodate additional uaser- 
designed program code. 


oe a ae ae th at. wie tae Ae ste 


Certain requirements and Limitations accompany progran EEC Face with 
CMS GEMCOS. a tist of these restrictions follows... 


ae The interfacing progran must have one of the following: 


(1) A minimum of one INITIAL INPUT CD for COBOL programs. | 


2) An INIT.~MSG segment ranging from 12 to 84 bytes in 
Length for MPLII programs. 


IThe prerequisites tisted above enable the program to receive 
—.._ is athe initiating message generated by the CS. This aessage. 
contains the names of the subnet queues and the dummy s at 


. NOTE 
jit is advisable to execute alt datacom 
programs through the MCS? any program 
_MI not executed through the MCS does not 
P |receive the initiating message with the 
subnet queue and dum@y station names. 


db. <A maximum of three ransaction queues (one primary and two t- 
i 
seccndary queues) may be used by a program. | 
ce A program may only have one comaunicate queue (CQ) to elive. 
responses to Network Control Commands and 


ES keyboard input of a terminal may not be 


@Ge A program may not operate in PARTICIPATION mode in one 
direction of transmission and itn NONPARTICIPATION mode 
in the cther direction. 


In the GEMCOS application program interface» programs have access to 
the following features of the CMS GEMCOS system. : 


ae Network Control Commands. 

b. Internal/external format. 

Ce PARTICIPATION/NQGQNPARTICIPATION acde. 
de Audit and recovery. 

e. Message tracing. 

f. Formatting. 

Ge Assignment/transaction- naeed routing. 
Ne Interprogram communication. 

1. System security. 

je Practice mode. 
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NETWORK CONTROL COMMANDS. | 

These commands attlecw a program to control the datacoa environment through 
the MCS and to request information from the MCS about the network. 
Further explanations of these commands may be found in the NETWORK 
CONTROL COMMANDOS sectione. 


INTERNAL AND EXTERNAL FORMAT. 

The programmer can request an internal format for responses to Network 
Controt Commands. Internal format affords the program greater ability 
to recognize and interpret these responses. (Refer to the NETWORK 
CONTROL COMMANDS section for more detail on internat foraat.} Since 
the message text is subject to changes external format should not be 
interpreted by the programs external format is easily understood a 

an operator. 


INTERNAL FORMAT. This format is designed for program processing. A 
program may request this format when sending a NCC to GEMCOS by setting 
the INTERNAL FORMAT flag in the MCS header. An example of this format 
is provided below. | 


Example: 
5GC-byte MCS header 
12-byte station name 
Nulf code (ASCII 300a) 


35-byte network controtter header (i.se.» the header of the last 
message pertaining to the current Network Control Commandd 


Annotated message result _ 


EXTERNAL FORMAT. This format is destgned to te read by an operator. 
External format ts the default. This format is presented betow. 


SG-byte MCS header 
ig-tyte station name 
Annotated message result 


PARTICIPATION AND NONPARTICIPATION MODE. | 

Either mode may be specified for any application program. PARTICIPATION 
mode reduces the speed in which programs interface but allows the MCS 

to provide the following features. 


ae Audit and recovery. | 

b. Transaction~based routing. 

Ce Application message tracing. 

de Practice mode. 

ee. A SO-byte message header on all messages. 


Only one major difference exists between PARTICIPATION and NONPARTICIPATION 
mode. A program in PARTICIPATION mode receives a 50*byte header with 

all messages and includes a similar header with all output messages. 

In NONPARTICIPATIOGN mode» the program only receives aossaGes with the 
50-byte MCS header from the MC 5S. 


NOTE - 
THCS interface onty supports 
NONPARTICIPATION mode. 


AUDIT AND RECOVERY. 

The MCS allows optional audit and recovery of atl or only user-selected 
messages from stations. Audit and recovery capabilities are onty 
available for programs in PARTICIPATION mode. 


MESSAGE TRACING. 

This feature altows the programmer to selectively trace messages for a 
programs queue» stations or for the entire network. Information from a 
trace can include the message texts» message header» network controller 
header» and MCP communicates. Output of the message trace can be 
directed to a tine printers stations or a disk file. Usuatty» only 
messages passing directly between the procram and the MCS may be 
traced. However» when the program is in NONPARTICIPATION mode» proo- 
gram messages may only be traced by using the GT Network Control Coa- 
mand.j (Refer to GT and TRACE in the NETWORK CONTROL COMMANDS section. ) 


FORMATTING. 

The MCS provides flexible fapwacting Capasi ities: They feature 
expansion and coapression of fields» insertion and deletion of fields, 
numeric editings and sonitoring of aete integrity. (Refer to the 
FORMATTING sectton.) | 


MESSAGE ROUTING. 

Messages may be routed in one of two ways? by assignment or by trans- 
action code. Assignment routing is used to route station messages to 
the program to which the station is attached. Transaction-based 
routing allows messages to be routed to various programs based upon the 
transaction codes within the message. For transaction-based routing» 

a waximue of 255 transaction codes which ere specified in TCL may be 
associated with each program. These codes facilitate transaction- 
based routing for the program and do not prectude the use of assign= 
ment routing or a combination of the two. However» only programs in 
PARTICIPATION mode may use transactionsbased routing. Associated with 
each trancode are two Sdigit numbers. These numbers are passed to the 
program in two transaction data fields of the 50-byte MCS message 
header. 


| INTERPROGRAM COMMUNICATION CIPC). — 
\CMS GEMCOS provides for Interprogram Comaunication ape). APC attlows_ 
programs to communicate directly with other programs» eliminating the 
use —ot— rey e Input/Output | 70) subsystem. Programs May use 


\jassignwent— or transaction based routing. 


IPC - ASSIGNMENT ROUTING. 

Using IPC and assignment routing a program references the dummy station 
names consisting of MX followed by a number» associated with the pro- 
gram it wishes to communicate with. A program that attachs another 
program shoudd not send messages to the prograsa that it 1s a attached 
to» until receiving an ATTACHED QUEUE message from the MCS. The 
ATTACHED QUEUE (AQ) flag set to 1. The first 12 bytes after the header 
3s the dummy station name. Programs using using assignment routtng may 
be participating or nonparticipating. 


NOTE 
Messages sent to an attached program 
before the ATTACHED QUEUE message is 
received may cause the sending program 
to exceed the transaction queue timit. 
The program may be suspended until a 
RECEIVE is performed on the transaction 
queue of the receiving prograa. 


Ipc - TRANSACTION BASED ROUTING. 

To use transaction based routing a program must set the trancode flag 
tin the MCS 50-byte header before sending a message to GEMCOS. The 
trancode flag is in byte position 41 of the MCS header. The MCS header 
should be followed by text which inctudes the trancode. Fefer to 
section 5 under features for an explanation of the 50-byte MCS header. 
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SYSTEM SECURITY. 
Programs and the entire network. are protected by a security wystem. A 


CONTROL status may the specified in Transaction Control Language for 

programs and stations. CONTROL status authorizes the program or sta- 
tion to perform functions that affect the network or programs. (For - 
more details refer to the TRANSACTICN CONTROL LANGUAGE sections) : 


PRACTICE MODE. 

Using the PRACTICE Network Control Commands stations may be pliaced in | 
practice mode. In practice mode» atl messages from the station to an 
attached program are sent with a 50-byte header in which the PRACTICE | 
flag is set to the value 1. For this feature to be availables the 
attached program must be defined tn TCL to be participating. The pro- 
gram is free in the usage of this features» for example» the program may 
prevent messages from a practicing station from affecting critical data 
in a data base. | 


| GENERAL PROGRAMMING PROCEDURES. © 
| Two basic procedures are required to initiate any interfacing program 
i First» to facilitate program interfaces the MCS executes the program 
i with an initiating message providing the names of the dum my station a 
f_ subnet queues for the program. Second» the program performs the firs 
| RECEIVE on the primary transaction queue allocated for it. Performin 


_the first RECEIVE attaches the queue to the program. 


INITIATING MESSAGE. | T 
WE ach prograa interfacing with the MCS sends messages to stattons in the |{ 
linetwork and rec pives messages from the datacom subsystem. Messages 

Fare received er pone OF more Saat saat e PR OueR RTER the area by 


reat Subnet queue» oT as” RRS STR TICES rrr Ta 


to to respond to Network Controi Commands issued by a program. ty, 


thaueue Dy name. | to €@ prograa nay ieee 
|iname by which eis gram is addressed dunn “Interprogram Reread 
PeTPC). The MCS uses an initiating message to pass al the names to the | 
program when 1t 1s executed. —— 


‘For a COBOL program» the initiating message is placed in the INITIAL ig 
{INPUT CD. The fotlowing represents the INPUT | CO: 7 


Example: 
SYMBOLIC QUEUE - (primary transaction queue name) 
SYMBOLIC SUB“QUEUE-1 - (communicate queue name) 
SYMBOLIC SUB-QUEUE~2 - (dummy station name) 
SYMBOLIC SUB-QUEUE? 3 - (first alternate transaction queue name). 
<next 12 bytes> | | ~ (second alternate transact ion queue. name) 


NOTE | 
The INITIAL INPUT CD must be iaplicitly 
redefined ty another record description 
so that the second alternate transaction 
queue name can be accessed. 


. WThe CMS COBOL language requires that» upon initiation» a COBOL orogran 
“Hmust remove and save the subnet queue and dummy station names from the 
PuINITIAL INPUT CO and replace them with spaces. 


For MPLII programs» the names appear as 12-byte fields within the 
INIT.MSG segaent in the same sequence as above. 


FIRST PROGRAM RECEIVE. 

After the proegragw is executed» the program sust perform the first 7 
RECEIVE on its primary transaction queue. This action causes the MCS to 
attach the program to the queue. The message to be read originates from 
the MCS and contains information about the initiating station Cor dummy 

station). The format of this message foltows. 


(50 bytes) MCS header {a description of this header 


may be found under FEATURES) 
(12 bytes) attached station name (Ci.ee» the name of the Station 
| nes «8 QOS Gummy station which noe 
attached) 
(16 bytes) access~key (from the operator's accesskey ) 
(not Limited) user text Cfrom the initiating command) 


The SYMBCLIC SOURCE CDC.ORIGIN for MPLII programs) contains MCS. 


SNA ISLES LD EEN RITES EY OO SAREE AI EEK LEME NIAA GOB LHS NO SOR LARAAAAL FRSA RTE HR: PS ASEAE ONLOAD VELA EID EAB ERA RA TREAD: Matipanwaniacasenea Nada TV TALON Df ge LRH RETNA INCA RENA SIOE NRHA EBT 


RAO LG INCHES LINO IIIE 


The final step in initiating a program only concerns COBOL programs. 
ythe destination count field in the OUTPUT CD must be set to the value 


NO001. Gnce this is completeds the prograr _is. “ready to. ‘perform ‘routine 
functions. = Eten eee ee 


RECEAPT OF MESSAGES: 


Messages are received on one of the following sutnet queues: 


URC ED Rta ETA NEE RSEE PRENSA Gb ANS IRN BOTH OAR TRILL REO ESET ASN RR RIESE ETE IS BENT CEL ROIS eg arenes 


BRIT ESV ARAM ETN 


ee 
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{PRIMARY TRANSACTION QUEUE. 
pThe transaction queue is the primary queue used to accept message Se | 
hone queue accepts two message types: administrative and transaction | 


ADMINISTRATIVE MESSAGES. TI | t ; 
[ehe SYMBOLIC SOURCE field in the INPUT CD. ains MC: In MPLII 
programS» the function, called DC.ORIGIN>» “supplies this information. A_ 
50-byte MCS header is included with each a ive messagée here 
are 12 administrative message types. With the exception of the INPUT 
FORMAT ERROR messages» all administrative messages are sent ds a resuit 

of the execution of a Network Control Command. Administrative messa 

identified by a unique fla } yt! 

header of each messa These flags are described under FEAFBURES in 
“this section. When an administrative flag is set in a header» alt 
other fields with the exception of the RECOVERY flag are zere. These 
twelve flags are as foltows: 


ae ASSIGN flag. 

de DELAYED MESSAGE fiag. 

e. FORMAT ERROR flag. 

f. HALT flag. SS 
ge LOGOFF MESSAGE flag. 

he LOGON MESSAGE flag. 

12 QUEUE ALLOCATED flag. 

je QUEUE ATTACHED flag. 

ke. TASK DETACHED flag. 

L. VACANT flag. 


TRANSACTION MESSAGES. For this type of message» the SYMBOLIC SOURCE 
fietd in the INPUT CD contains a source other than MCS. The function» 
called DC.ORIGIN»s suppties this information for MPLII programs. Also» 
transaction messages include an MCS header if the message source is in 
PARTICIPATION mode. The following fields in thts header may contain data: 


ae PRACTICE MODE flag. 
be. RECOVERY flag. 

e. SEQUENCE NUMBER. 

de STATION DATA. 

@e TRANSACTION DATA le 
f. TRANSACTION DATA 2. 


The remaining fielas in the 50-byte MCS header Ci-ees» CONTINOE> FORMAT 
REQUEST» NETWORK CONTROL COMMAND» INTERNAL FORMAT» TRANCODE» and MODULAR) 
are set and sent by a progras to the MCS Cto perform ene associated 
functton). 


The content and format of transaction messages» following the header» 
are entirely determined ty the application program in use. Refer to 


FEATURES tn this section for detailed descriptions of the MCS header 
fields. 


ALTERNATE TRANSACTION QUEUE. 
This queue can be used by the program in a variety of waysSe An 
application program can be prograamed to devise a priority scheme to 
receive messages froa the Transaction Queues. For exampte» an apptli- 
cation prograa coutd be programmed to service the primary TQ more often 
than the secondary TQ» thus stations attached to the prisary Transaction 
Queue are given a higher priority than stations attached to an alternate 
Transaction Queue. fherefore nessages on the prisary Transaction Queue 
are received with tess delay than those originating from an alternate 
queue. Administrative messages and Interprogras Coamsunication are 
performed onty on the primary Transaction Queue. 


COMMUNICATE QUEUE. | 3 | 

Only BREAK sessages issued by an operator and MCS responses to Network 
Controt Commands issued by a program are received by this queywe. fhe 
communicate queue receives these sessages in both external and internat 
formats. Messages in external format contain a fetch value fottowed 

by a short phrase specifying the origin of the sgessage (@.ges FROM C5). 
Messages on the communicate queue do not have the 50-byte MCS teader. 
Messages in internal forsat consist of a 3-byte fetch value» followed 

by information presented in internal format. The fetch value of Doth 
 Gnternatly and externally formatted messages is interpreted as foltows: 


First byte: Cin hexadecimal) 


00 - Result OK (see second and third bytes) 

10 - No message after datacom dequeue 

20 - Abnormal result (see second and third bytes ) 

30 - Error detected by MCS (see second and third bytes) 
£0 - Resource teaporarity unavailabte 

80 - Fatat errors Ceegee invalid MCP communicate ) 

FF = Break message : 


If the first byte is 2002 and the Network Controt Comaand was not ZIP» 
it is interpreted that the command was transmitted successfully. 
However» if the first byte is 20023 and the command was ZIPs the second 
and third bytes say contain a vaiue generated by the zipped progran. 
Interpretation of this value is entirely dependent upon the zipped 


programe 


If the first byte consists of 32048» the second byte is interpreted 
in one of the following ways: 


Second bytes 


00 - Prograa toad failure or communicate error Creason may 
be found in third byte) 


O01 - Communicate error’ value in third byte is implementation 
dependent Ce.ge» hardware errors) 


10 - EOF encountered on input for sequential access 


20 - Invatid key (reason may be found in third oyte)d 
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30 - Permanent Chardware) error on file (reason may be found 


4C 


80 


in third byte) 


- Bicck count error on close 


A ZIP command with invalid SCL (System Controt Language) 


was transmitted to the MCP 


If the second tyte contains 200d» 3204» or a30a» the third byte is 


interpreted in one of the following ways: 


Third byte: 


PROGRAM LOAD ERRORS 


- Program file not found 


Interpreter file not found 


No memory 

No user disk 

Mix full 

Userwcount error 
Duplicate pack 
Invalid toad request 
MCS atready present 
Disk error , 
Code fite error 


Cif the second byte is @CCa» 
interpreted as follows) 


the third byte ts 


Ittegal data communication load request 


Program discontinued ty 0S coamand 


Prograag discontinued by OP command 


COMMUNICATE ERRORS 


Bad message type 

Bad station nuaber 
Bad queue reference 
Bad subnet number 
Text size too big 
Null message reference 
Byte index too big 
Bad task number 

Bad tine nusaber 

Bad modem number 

Bad terminal number 
No space 

Station not attached 


Coamunicate not itnplemented 


Lisit not allowed 
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Station already attached 
Attribute @ismatch 

Direct connect tine 

Full duplex mismat-ch 
Incomplete variable 

Improper tine condition 
Message queue 

No vacancy on Line 

Speed mismatch 

Implementation dependent error 


Third byte: Cif the second byte ts a22Ca» the third byte is 


interpreted as follows). 


No further information 

Sequence error on output to indexed file 

Duplicate key on tndexed file 

No such record Cattempt to read beyond EOF) 

Boundary violation Cattempt to write beyond allocated 
area) 


Third byte: (Cif the second byte is @30a> the third byte is 


00 
10 


20 - 
30 - 


40 


interpreted as follows) 


No further information 
Read error on data file 
Write error on data file 
Read error on key file 
Write error on key file 


If the first byte is 20023 or 2308» the second and third bytes offer 


additional 


information. The second byte indicates the command number. 


The third byte provides the response number. Explanations of the 
response numbers are presented in the NETWORK CONTROL COMMANDS section. 
The following table Lists all command numters and the meaning of each. 


Command 

Number_ Meaning 
Ol Implied EX 
02 AT or EX 
03 | RN 
04 PL 
95 DT 
06 MX 
97 PR 
08 GT 
09 NT 


Command 


Number_ : Meaning 
OA CF 
0B BREAK 
Oc CONF 
00 END 
OE RL 
OF RS 
10 RD 
11 DI ALIN» DIALOUT 
12 DISC 
13 OL 
14 RY 
15° NY 
16 EI 
17 DI 
18 TO 
19 | STOPTEST 
LA TEST 
13 7 ZIP ° 
1C WMI 
— 10 SET 
1E ENQ 7 | 
iF IL» IC» Ob» OC» QL» QC» SL» SC Ciaplied ENQ) 
20 ORE | 
21 CL 
22 TERM 
23 LL 
24 LC 
25 LT 
26 $0 
27 RO 
28 LO 
29 WRU 
2A cc 
2C ~MCSLOGON 
20 — MCSLOGOFF 
2E MCSRUN 
2F | README SSAGES QUEUE 
30 ASSIGN 
31 CHANGE 
52. RESTORE 
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Command 
Number _ Meaning 
33 CLOSE 
34 DETANK 
35 AP3O00STATUS 
36 DUMP 
38 , HALT 
39 _ tCOGOFF 
3A : LOGON 
38 | MERGE 
3C PRACTICE 
350 | RUN 
3E SEND 
3F | STATUS 
49 , STOP 
42 | TRACE 


If the first byte contains 24902 and the Last communicate executed ty 
the MCS was a conditional 1/0 operations» the value of the second and 
third byte is either the event number corresponding to the message 
(that would have been printed on the SPO had the communicate not been 
conditional) or zero Cif there is no corresponding events e.g. a 
conditional failure when opening a file). 


If the first byte contains 280d» the value of the second and third 
bytes is the CMS event number. For wore detail» refer to the CMS 
Systems Software Operation Guides form number 2007258. 


The communicate queue is always cteared by the MCS before receiving a 
response to a Network Control Command. However» if A BREAK message is on 
the queue» it is not cleared. Therefore» to follow up on a response to 

a Network Control Commands the program must perfora a RECEIVE on the 
communicate queue. BREAK messages can be distinguished from Network 
Controt Command responses ty the first three bytes: a@FFFFFF2. Also» 
BREAK messages are in external format. 


The SYMBOLIC SOURCE field of the INPUT CD COC.ORIGIN fietd for MPLII 
programs) provides the name of the ee ncees The sender may be areal or 
Suasy station. 


a= Pe 


Whenever a message is received» the INPUT STATUS KEY field 
C(DC.INPUT.STATUS field for MPLII programs) must te tested for errors. 


Internal “popeat may te paaqueseed for Network Control Commands ty 
transmitting the ccmmand with a header tn which the INTERNAL FORMAT 
flag is set to the value 1. The internal format for Network Control 
Command responses is presented tn the NETWORK CONTROL COMMANDS section. 


In PARTICIPATION modes a 5C-byte header precedes each incoming message. 
In NONPARTICIPATION mode» the program tests the SYMBOLIC SOURCE fietd 
(DC.QRIGIN fieid for MPLI!I programs) on each message received. Onty 
messages from station MCS are preceded by the 50O-byte header. 


NOTE 
This onty applies to GEMCOS interface. 
TMCS interface programs do not utilize 
the SOQ-byte MCS header. 


MESSAGE TRANSMISSICN. 

Program messages are transmitted to stations. Each station has a_12=- 
byte name. When a station 1s assigned to a programs the program — 
receives the name cf the station by way of the ASSIGN or EX message. 
Also» once the station has sent the program a message» the program can | 
extract the station name from the SYMBOLIC SOURCE field in the INPUT CD. 
(DC.ORIGIN field for MPLI!I programs). The fotlowing station names are | 
possible. | 


Generally» a program is unable to distinguish between various station | 
types. However» this does not interfere with the ability of a program 
to respond to ‘Station messagese 


TRANSMISSION RULES. | 
If messages are transmitted to a stations the following rules determine — 
whether the transmission is allowed by the MCS. 


ae For messages to FEAL STATIONS: 


i) If the station is attached to another program the 
“transmission ts not attowe 


2) If the program is utilizing Transaction Based Routing (TBR)» 
the transmission is permissable. _ be Bhd aid | 


3) If the station is attached to the program transmitting the 
message» the transmission is permitted. 


bt. For messages to station MCS» ail messages are permitted. 

ce. For messaces to station DC» all messages are permitted. 

d. For messages to station MX<n>» all messages are permitted if 
the station transmitting the messages is attached to the 


ee. For messages to station CC» ail messages are permitted if 
station CC is attached to the program. 


To determine whether the message was transmitted successfully» the 
QUTPUT STATUS key (DC.GQUTPUT.STATUS for MPLII programs) may be examined. 


PMcs HEADER. 

FALL messages from a program in PARTICIPATION mode must inctude a 50- 
ltyte MCS message header. This header may not contain data CASCII 
Hzeroes) untess it is addressed to the MCS. 


CUTPUT FORMATTING. 

Formatting program output messages may he requesved from the MCSs when 
the message is transmitted to the MCS» the FORMAT REQUEST flag in the 
message header must be set to the value i.e The name of the station (12 
bytes) for which the message is intended and the format name (12 bytes) 
are entered tefore the message text. 


NETWORK CONTROL COMMANDS. 
A program can also send Network Control Commands to the MCS. The pro- 
gram constructs a message comprised of a 50“byte message headers in 
which the NETWORK CONTROL COMMAND flag is set to the value 1x followed 
ty the actuat text of the Network Control Command (without the control 
character). The entire message 1s sent to dummy station MCS. The MCS 
gives an tmmediate and possibly a delayed response to a NCC message. 


IMMEDIATE RESPONSE. This response signifies a prompt acceptance or 
rejection of the Network Controt Command. | 


To follow up on the Network Controt Command responses» the program should 
follow each Network Control Command with receives on the communicate 

queue until the value of the END KEY COC.ENDKEY for MPLII programs) 

field does not equal 2. Untess a BREAK message is on the communicate 
queue» it 1s cleared by the MCS before recieving a Network Cantrot Command 
respcnse. Thus» each subsequent response causes the preceding response 

to te lost. 


DELAYED RESPONSE. The MCS utilizes this response to inform the progran 
of the results of performing the command. A delayed response is sent 
to the transaction queue. The DELAYED RESPONSE flag in the gessage 
header of this response type is set to the value 1. MCS appears in 

the SYMBCLIC SOURCE field of the INPUT CD CDC.ORIGIN fieid for MPLII. 
programs) to indicate the origin of this response. Only certain Net= 
work Controt Commands cause delayed resporses. Refer to the NETWORK 
COATROL COMMANDS section to ascertain the possible responses to each 
commande | 


PROGRAM EXECUTION BY ANOTHER PROGRAM. | 

A program which attaches another program should receive the ATTACHED 
QUEUE message from the MCS before transmitting messages to the attached 
programe The ATTACHED QUEUE message includes a header tn which the 
ATTACHED QUEUE CAQ) flag is set and the ldg-byte dummy station name is ~ 
the name of the attached program. Messages sent to the attached pro- 
gram before the ATTACHED QUEVE message may exceed the subnet queue = 
Limit ands consequently» the program may te suspended until a RECEIVE — 
is performed on the transaction queue of the program. | 


RECOVERY. 

As the suspended program is being recovered» the MCS does not contin- 
uously send recovered messagess the MCS must be prompted to send each 
subsequent aessage.e. The CONTINUE message is sent from the program to 
dummy station MCS to proapt the MCS. The CONTINUE message consists of 
an MCS heacer itn which the CONTINUE flag ts set to the vatue Il. 


SKIP CONTROL. | | 

A program sending a command to dummy station MCS may include a tag (to 
be returned cr forwarded) with all responses resulting from the command. 
The tag appears in the SKIP CONTROL field of the Network Definition 
Language message header. This tag is placed in the SKIP CONTROL field — 
by performing a SEND (DC.SEND for MPLII programs) AFTER/BEFORE ADVANCING 
<tag> LINECs) command. <A number between 13 and 99 is specified for 
<tag> in the command. It witl be passed to a program Cin ASCII) as the 
month portion tn the date field of the INPUT CD message (DC.DATE mes~. 
sage for MPLII programs). Thus» any value in the month area which is 
greater than 12 €3132 tin hexadecimal) can be assumed to be a taq. 


NOTE 
If the tag is associated with a 
DT <queue name>/ or OT <queve name>/MXn 
commands the program sending the 
command will not actually be detached 
from the program. Howevers ati responses 
to the command are fornarded as tf the 
program were detached. 
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COS8CL PROGRAM EXAMPLE. 
The following is a simple exampte of a COBOL program 


designed to 


interface with the MCS» receive and return messages» and take 
appropriate action for administrative messages. 
IDENTIFICATION DIVISION. 
PROGRAM“TD. COBOLTASK. 
EAVIRONMENT OFVISTCN. 
DATA DIVISION. 
WORKING@"STORAGE SECTION. 
RRAEKREKKRAKKEKRKRKRAKKKRKK 
* MESSAGE BUFFERS * 
kee aeRKAKEKRAKRER KK KEK 
Ci INPUT“RECORD : PIC X(19862). 
Oi ADMINISTRATIVE“RECORD REDEF INES INPUT*“RECORD. 
03 MCS*HEADER. | 
05 MSG"PRACTICE-MODE-FLAG PIC 9. 
05 MSG*TRANSACTION-DATA@~1 PIC 9€5). 
05 MSG*TRANSACTION“DATA~2 PIC 9€5). 
05 MSG"STATION-DATA | PIC 9(€5). 
05 MSG"HALT“FLAG PIC 9. 
O05 MSG*RECOVERY-FLAG PIC 9. 
95 MSG*CONTINUE“FLAG PIC 9. 
05 MSG"SEQUENCE-NUMBER . PIC 9(7). 
OF MSG*ASSIGN-FLAG PIC 9. 
05 MSG°CLOSE“FLAG PIC 9. 
05 MSG*BROADCAST<-FLAG PIC 9. 
05 MSG*FORMAT“REQUEST“FLAG | PIC 9. 
05 MSG*FORMAT“ERROR“FLAG PIC 9. 
05 MSG*NETWORK-CONTR=COMMAND“FLAG PIC 9. 
05 MSG*INTERNAL@“FORWMAT FLAG PIC 9. 
05 MSG"DELAYED@“MESSAGE-FLAG PIC 9. 
05 MSG"LOGON-MESSAGE°FLAG PIC 9. 
05 MSG*LOGOFF<MESSAGE-FLAG PIC 9. 
C5 MSGrTENABLED“QUEUE-FLAG PIC 9. 
O05 MSGr*ATTACHED“QUEUE“FLAG PIC 9. 
C5 MSG*TASK@*DETACHED-FLAG PIC 9. 
05 MSG°VACANT“FLAG PIC 9. 
05 MSG*TRANCODE-FLAG PIC 9. 
05 MSG*MOCULAR@=FLAG PIC 9. 
9(8). 


05 FILLER | 7 PIC 


FN sea ») 


03 MCS“MESSAGE. | a\ 


i 
F 


Cc xci920). 
O07 MCS“ASSIGN“ACCESS@KEY PIC X(16). 
O07 MCS@SIGN“ON-TEXT PIC X(€1904). 


05 MCS~BROADCAST“MSG REDEFINES MCS@MSG"TEXT 
| PIC X€1920). 
05 MCS“INPUT“FORMAT“ERROR“MSG REDEFINES MCS“-MSGWTEXT. 


O07 MCS-INPUT-FORMAT-“NAME PIC X(12). 
G7 MCS@INPUT“FORMAT-ERROR“NUMBER PIC 9(3). 
C7 MCS-INPUT“FORMAT-ERROR=-LOC PIC 9(5). 
07 MCS*PARTLY“FORMATTED<-MSG PIC X(1900). 
05 MCS“DELAYED“MSG REDEFINES MCS-MSG“TEXT. — 
O07 MCS“FILLER | PIC X. 
C7 MCS“DELAYED“MSG-NDL“HEADER PIC X(35). 
07 MCS“DELAYED-“MSG°TEXT PIC X(1884). 
01 TRANSACTION“-RECORD REDEFINES INPUT“RECORD. 
O03 FIRST“TWO"=CHARACTERS | PIC XX. 
03 FILLER PIC XC1980). 


O01 MISCELLANEOUS“DATA. 
03 ATTACHED=STATION PIC X(12). 

03 ZERO-HEADER PIC X(€50) VALUE 

"1000000000000000000000000090C0000000000000000000000". 


COMMUNICATION SECTION. 
CO INPUT“CD FOR INITIAL INPUTS 


SYMBOLIC QUEUE IS SYMBOLI C-QUEUES | 
SYMBOLIC SUB-QUEUE-1 IS SYMBOLIC-SUB-QUEUE-13 
SYMBOLIC SUB-QUEUE-2 IS SYMBOL IC“SUB-QUEVE-23 
SYMBOLIC SUB-QUEUE=3 IS SYMBOLIC-SUB-QUEUE-33 
MESSAGE DATE IS MESSAGE-DATES 

MESSAGE TIME 1S MESSAGE°TIMES 
SYMBOLIC SOURCE | IS SYMBOLIC-SOURCE; 

TEXT LENGTH IS INPUT@TEXT“LENGTHS 
END KEY IS END-KEY? 

STATUS KEY LS INPUT“STATUS“KEY3 
MESSAGE COUNT IS MESSAGE-COUNT. 

O1 INITIAL“INPUT-CD. | 
03 FILLER PIC X€12). 

03 SYMBCLIC-SUB-QUEUES PIC X(36). 
03 FILLER | PIC X39). 

CD OQUTPUT-CD FOR OUTPUTS | 
DESTINATION COUNT IS DESTINATION-COUNT? 
TEXT LENGTH IS QUTPUT-TEXT-LENGTHs 
STATUS KEY IS QUTPUT~STATUS-KYE3 
ERROR KEY IS ERROR-KEYS 


SYMBOLIC DESTINATION 


SYMBOLIC-DESTINATION. 
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PROCEDURE DIVISION. 


TOSSES RSESRESBDERESEARABRALSASAERASSLAALRARELARARARZAELAASE AAR SREERES SALES ARSSA RAR SE SS FS 


RECEIVE“AND-ECHO-MESSAGES. 


MOVE 1 TO DESTINATION-COUNT. 

MOVE SPACES TO SYMBOLIC“SUB~QUEUES. 

RECEIVE INPUT*CD MESSAGE INTO INPUT@“RECORD. | 

PERFORM CHECK“INPUT~STATUS. | 
This first receive causes ATTACH QUEUE request. If allowed» the 
INPUT“RECCRO will contain an MCS header foltowed by the station name 
of the sender» the ACCESS KEY Cif any) used when logging on Cif 
required)» and text from the initiating command. 
—MOVE MCS“STATION-NAME TO ATTACHED-STATION. 

PERFORM RECEIVE"MESSAGE*AND“PROCESS 

UNTIL FIRST“TWOTCHARACTERS = "DS". 
STOP RUN. 


SRK AKER KEAH EKER KEK EK EEK EKER EKKE KEK EK KEKE KEKKEEEEEKEREKRAKEKERRKEKKKEKEK 


RECEIVE“MESSAGE“AND@“PROCESS.~ 


+ ©  & 


RECEIVE INPUT*CD MESSAGE INTO INPUT-RECORD.: 
PERFORM CHECK=- Soe ae STATUS. : 
IF SYMBOLIC*SOURCE = "MCS" 
| PERFORM PROCES S“ADNN-MSG“AND=SAVE"TEXT 
a THRU PROCESS~ADMN=MSG"EXIT 

ELSE | 

PERFOCRM ECHO“MSG-IF“NOT-DS. 

kei ee ee ee RR RARE RRMA KERR EERE EE REREKERREREKER ERR KRREK 


PROCESS“ADMN@MSG~AND“SAVE*TEXT. 


‘IF MSG*HALT-FLAG = 1 
DISPLAY "MCS HALTED" 
STOP RUN. | 
IF MSG*ASSIGN-“FLAG = 1 : | 
DISPLAY "SIGN-ON MESSAGE FROM "» MCS“STATION-NAME | 
IF INPUT“TEXT“LENGTH > 78 
MOVE MCS“SIGN-ON-TEXT TO INPUT-RECORD 
GO TO PROCESS“ADMN@MSG-EXIT. 
IF MSG°CLUSE-FLAG = 1 
DISPLAY "SIGN-OFF MESSAGE FROM “+ MCS-STATION-NAME 
GO TO PROCESS~ADMN=MSG"EXIT. 
IF MSG~BROADCAST-FLAG = 1 
MOVE ATTACHED@STATION TO SYMBOLIC“SOURCE 
MOVE MCS-BROADCAST“MSG TO INPUT-“RECORD 
SUBTRACT 62 FROM INPUT@TEXT“LENGTH 
PERFORM ECHO-MSG*IF-NOT-DS 
GO TO PROCESS“ACMN=MSG°EXIT. 
IF MSG“FORMAT~ERROR-FLAG = 1 | 
DISPLAY “ERROR IN FORMATTED MESSAGE FROM *> 
| MCS“STATION“NAME 
MOVE MCS“STATION-“NAME TO SYMBOLIC“SOURCE 
MOVE MCS“PARTLY-FORMATTED“MSG TO INPUT-RECORD 
SUBTRACT 82 FROM INPUT@“TEXT@“LENGTH © 
PERFORM ECHO-MSG*IF°NOT“0S 
GO TO PROCESS~ADMN=MSG“EXIT. 


oak as 


IF MSG-DELAYED“MESSAGE-FLAG = 1 
‘DISPLAY "OELAYED RESPONSE FROM "» MCS*STATION“NAME 
MOVE MCS“DELAYED@-MSG-TEXT TO INPUT-RECORD | 
GO TO PROCESS“ACMN-MSG"EXIT. 
IF MSG@TASK*DETACHED“FLAG = 1 
DISPLAY "DETACH MESSAGE FROM "» MCS*STATIGN-NAME 
— 6§<G0 TO PROCESS~“ADMN-MSGWEXIT. 
IF MSG*VACANT<FLAG = 1 
DISPLAY "GUEUE VACANT” 


STOP RUN. 
PROCESS“ADMN°MSG-EXIT. 
EXIT. 


de ete EE REE RR EKER RERREEE EERE RERAEREHEEEEEERE 


| ECHO-“MSG-IF-NOT-DS. 


SES OTS EN LER STH TH oT eeueeres "pst 


| | ) UTPUT- aS , : 
PERFORM CHECK@OUTPUT@ STATUS 
CREAR EARNER ERE EERE RK RRRER ERE R EER ERR EERE EERE EE EEER ARE REE RRR Ee 


CHECK“ INPUT“STATUS. 


IF INPUT=“STATUS*KEY = 20 THEN 
*« The tast terminal signed off via a CLOSE/DT Network Control Command« 


* = suggest that you terminate CEOJ) & 
DISPLAY SYMBOLIC“QUEUE» "DETACHED/UNKNOWN* 
STOP RUN | 
ELSE 


IF INPUT*STATUS*“KEY = 91 THEN 
DISPLAY "MCS/DC SUBSYSTEM NOT AVAITLASBLE™ 
STOP RUN. 


eee RR RR EERE EER EER RR EREERRE RE EERE ER ER ERE ERE ERE REE REE 


CHECK@QUTPUT“STATUS. 


IF OUTPUT“STATUS“KEY = 20 
* This indicates the terminal has signed off via a CLOSE/DT Network * 
* Controt Cemmand * 

DISPLAY SYMGOLIC@DESTINATION>s “DETACHED/UNKNOWN™, | 
INPUT“RECORD 

ELSE | 
IF OVTIPUT“STATUS“KEY = 30 

MOVE 1 TO DESTINATI ON“COUNT 

SEND OUTPUT=CD FROM INPUT“RECORD WITH EGI 
ELSE 

IF QUTPUT@STATUS*KEY = 59 

DISPLAY "CHAR COUNT > LENGTH OF OUTPUT BUFFER ** 


ELSt 
TF GQUTPUT“STATUS“KEY = 91 
DISPLAY "MCS/0C SUBSYSTEM NOT AVAILABLE*® 
STOP RUN. 


Se Ke te He ie Tee te HR Ke RK KEE EE ERE REKE EEE EK ERE EEE REEEE 


END“ OF “JOB. 
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MPLIIT PROGRAM EXAMPLE. 
The following is a simpte example of an MPLII program designed to 


interface with the MCS» receive and return messages» and take 
appropriate action for administrative messages. 
PFOCEQURE RECEIVE. AND.ECHO.MESSAGES> 90000100 
| | | 02009200 
SEGMENT INITIAITNG. MESSAGE (0 INIT .MSG)>5 00000300 
60000400 
REMAP INITIATING. MESSAGE: 90000500 
00000600 
TQ CHARACTER €12)3 00000700 
| 00000806 
DECLARE O01 INPUT.RECORD> 00009900 
03 DUMMY €1982) CHARACTER (€1)5 00001000 
00001100 
REMAP INPUT.RECORD: 00061200 
| 00001300 
01 ADMINISTRATIVE-RECORD>» 00001400 
093 MCS.~HEADER> : 06001500 
05 MSG.~PRACTICE.MODE.FLAG CHARACTER (€1)% 900001600 
05 MSG*TRANSACTION.DATA.1 CHARACTER €5)8 00001700 
05 MSG.TRANSACTIGN.DATA.«2 CHARACTER (€5)» 00001800 
05 MSG.~STATION.DATA CHARACTER (€5)» 00001900 
05 MSG.HALT.FLAG CHARACTER (€1)» 00062000 
05 MSGeRECOVERY.FLAG CHARACTER €1)e8 00002100 
05 MS5G.CONTINUE.FLAG CHARACTER €1)» 00002200 
05 WMSG.SEQUENCE .NUMBER CHARACTER (7)» 00002300 
05 MSG.ASSTIGN.FLAG CHARACTER (1)» 00002400 
05 MSG.CLOSE-FLAG CHARACTER (€1)» 00002500 
05 MS5SG.BROADCAST.FLAG CHARACTER (1)8 00002600 
05 MSG.~FORMAT.REQUEST.FLAG CHARACTER (€1)A 00002700 
05 MSG-FORMAT.ERROR.FLAG CHARACTER (1)8 00002806 
05 MSG.NETWORKCONTROL.COMMAND.-FLAG CHARACTER (1)5% 000029006 
05 %MSGeINTERNAL.FORMAT.FLAG CHARACTER (€1)5% 000063000 
05 MSG.DELAYED.~MESSAGE.FLAG CHARACTER (€1)»% 00003100 
05 MSG.LOGON.MESSAGE.FLAG CHARACTER €1)»5 006003200 
05 MSG.LOGOFF.MESSAGE.FLAG CHARACTER C1)» 09003300 
05 MSG.ENABLED. QUEUE .FLAG CHARACTER (1)» 900034006 
05 MSG.ATTACHED.QUEUE.FLAG CHARACTER (€1)56 00003500 
05 MSG.TASK.DETACHED.FLAG CHARACTER (€1)» 000903600 
05 MS5G.VACANT.FLAG CHARACTER €1)» 06003700 
05 MSG.~TRANCODE.FLAG CHARACTER (€1)8 00003710 
05 MSG.~MODULAR.FLAG CHARACTER C1)» 00003720 
05 DUMMY CHARACTER €8)5% 00063800 
03 %\MCS.~MESSAGE> 00003900 
05 MCS.STATION.~NAME CHARACTER €12)¥»% 00064000 
05 MCSeMSG.TEXT oe 00004100 
Of DUMMY (1920) — CHARACTER (1)5 06004200 
06064300 


DECLARE G1 ZERO-HEADER CHARACTER 
| O1 ERROR.MSG CHARACTER 
01 SENDER CHARACTER 
O1 ATTACHED.~STATION CHARACTER 
O1 MSG-LENGTH FIXED, 


C50)» 


(50). 
(12)> 
(€12)> 


ZERO.HEADER 2= "00000000000900000000000000 000000000000000000"s 


PROCEDURE CHECK INPUT.STATUS> 


IF DCwINPUT.STATUS = 20 THEN 
DO» | 
ERROR-MSG z= TQ 
SUBSTR CERROR.MSGs» 13) c= 
DISPLAY CERROR.MSG D> 
STOP> 
—END> 
ELSE | 
DC» 


@ am 
ou 


"DE TACHED/S UNKNOWN; 


91 THEN 


DISPLAY C"MCS/DC SUBSYSTEM NOT AVAILABLE”); 


S TOP> 
END; 
END CHECK. INPUT.STATUS=, 


PROCEDURE RECEIVE»MSG.AND.PROCESS3 
PROCEDURE ECHO.MSG.IF.NOT.DS3 


PROCEDURE CHECK. OUTPUT.~ STATUS; 
IF DC.OUTPUT.STATUS = 20 THEN 
Daz 


@ wn 
eed 


-ERROR.MSG DC ~ORT GIN; 
SUBSTR CERROR.MSG» 13) 
DISPLAY CERROR.MSG)> 
END» 
ELSE 
IF DC.OUTPUT.STATUS = 
DOs 


91 THEN 


"DET ACHED/UNKNOWN"™; 


DISPLAY C™MCS/DOC SUBSYSTEM NOT AVAILABLE™)> 


STOP> 
END>s 


00004400 
9€004500 
00004600 
06004700 
00004800 
00004300 
00005000 
00005100 
90005 200 
00005300 
06005400 
90005500 
00005600 
00005700 
00005800 
00005900 
90006000 
00006109 
00006200 
00006309 
00906400 
00006506 
00006600 
90006700 
00006800 


00006990 © 


00007609 
00007100 
00007200 


-00007 306 


00007406 
0¢007500 
00007609 
00007700 
00007800 
00007900 
00008000 
00008100 
00008200 
00008300 
00008400 
00008500 
00008600 
00008700 
00008800 
00008900 
00009000 
600009199 
0060092006 
00009300 
00009400 


END CHECK.CUTPUT.STATUS:, 


IF SUBSTR CINPUT.RECORD» O» 2) /= "DS" THEN 
«003 
DC.SEND CSENDER» INPUT.RECORD» MSG.LENGTH)3; 
CHECK eQUTPUT.STATUSS 
END; 
END ECHO.MSG.IF-NOT.DS3 


PROCEDURE PROCESS.» ADMN MSG. AND» SAVE.TEXTS 


IF MSG.HALT.~FLAG THEN 
DO» 
DISPLAY C"MCS HALTED"); 
STOP» 
END» 
IF MSGeASSIGNeFLAG THEN 
DOs 7 
ERROCR.MSG == “SIGN ON MESSAGE FROM “> 


SUBSTR CERROR.MSGe 21) 2= SUBSTR CINPUT.RECORD®50» 12)3 


DISPLAY CERROR.MSG)>s 
IF MSG.-LENGTH > 76 THEN 


DU; , 
INPUT.-RECORD = SUBSTR CINPUT-RECGRD» 78)> 
RETURN; 
END=> 
END; 
IF M3G.CLOSE.FLAG THEN 
DOs 


ERROR.MSG 2= “"SIGN“OFF MESSAGE FROM "> | 
SUBSTR CERROR MSG» 22) c= MCSeSTATION.NAME> 
DISPLAY CERROR.~MNSG)>; 
RETURN, 

END; 


90009500 
00009600 
0¢009700 
00009800 
00009900 
00010000 
00010100 
000102006 
00010300 
00010400 
900010500 
00010600 
00010700 
00010806 
00010900 
00011000 
00011100 


600011200 


00011300 
00011400 
90011500 
00011600 
00011700 
00011800 
00011900 
00012000 
00012100 
00012200 


06012300 


00012400 
00012500 
00012600 
00012700 
00012800 
00012900 
00013000 


* 00013100 


60013200 


IF MSG.BROADCAST.FLAG THEN 
DO; : | 
SENDER := ATTACHED.STATION? | 
INPUT.RECORD := SUB8STR CINPUT.RECORD» 62)3 
MSGeLENGTH 2= 623 | 
ECHC.MSG.IF.NOT.OSS 
END3 
IF MSG.sFCRMAT.SERROR.FLAG THEN 
DOs _, 
ERRGR.MSG := "ERROR IN FORMATTED MESSAGE FROM * 
SUBSTR CERRORMSG» 325 12) t= MCS.STATION.NAMES 
DISPLAY CERROR.MSG)3 
SENDER := MCSeSTATION.NAMES 
INPUTsRECORD 2= SUBSTR CINPUT.RECORD> &82)3 
MSGeLENGTH t= 823 
ECHC. MSG.IF.NOT.DS3 
RETURN; 
ENDS | 
IF MSG-DELAYED.MESSAGE «FLAG THEN 
DO; . 4 
ERRGRMSG := "DELAYED RESPONSE FROM "5 
SUBSTR CERROR.MSGe 226 12) 2= MCS.STATION.NAMES 
DISPLAY CERROR.MSG)S | 
INPUT.RECORD s= SUBSTR CINPUT.RECORD» 62)3 
— RETURNG 
ENDS 
IF MSGsTASK.DETACHED.FLAG THEN 
bos | | 
_ ERROR.MSG := "DETACH MESSAGE FROM "3 


SUBSTR CERROR«MSGe 20» 12) 2:= MCS~.STATION.NAMES 


DISPLAY CERROR. MSG); 
RETURN, 
END> 
IF MSGeVACANT.FLAG THEN 
DO>s 
DISPLAY C"QUEUE VACANT™ D> 
STOP; 
END>. | | 
END PROCESS. ADMN.MSGeAND. SAVE. TEXT> 


DC-RECEIVE CTQ» INPUT.RECORD»> 1970); 
CHECK. INPUT.STATUS> 
SENDER s= OC.ORIGIN: 
MSGeLENGTH <= OC.TEXTLENGTH; 
IF SENDER = "MCS" THEN 
PROCESS.ADMN.MSGeANDeSAVE. TEXTS 
ELSE 
ECHO.MSGeITF2NOT.US>» 


END RECE ITVE.MSG2AND.PROCESS>» 


00013300 
660013400 
00013500 
00013600 
00913700 
00013800 
00013900 
06014000 
00014100 
00014200 
00014300 
00014400 
00014500 
06014600 
00014700 
0€014e800 
00014900 
00015000 
00015100 
0€015200 
00015300 
00015400 
90015500 
00015606 
00015700 
00015800 
00015900 
00016000 
00016100 
00016200 
00016300 
90016400 
00016500 
00016600 


—600016700 


00016800 
00016900 
00017000 
006017100 
00017200 
00017300 
00017400 
000175090 
00017600 
00017700 
00017800 
00017900 
00018000 
00018100 
00018200 
00018300 
00018400. 
0900185090 
00018600 
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DCeRECEIVE (TQ5 INPUT.RECORD» 1970); 


CHECK. INPUT.STATUSS 00018890 
SENDER := CATTACHED.sSTATION 2= DC.ORIGINI; 00018900 
MSGeLENGIH s= OC.TEXTLENGTH? 06019000 
DO FOREVER: : 00019100 
IF SUBSTR CINPUT.RECORD> O» 2) = "DS™ THEN 00019200 | 
UNDOS 00019300 
ELSE 00019400 
RECEIVE.MSGeANDePROCESS3 00019500 
END; 00019600 
STOP3 ) 00019700 
END RECEIVE.AND.ECHO.MESSAGES3 06019800 
FINS 06019900 


00918700 
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Controt Language has certain requirements which differ from a GEMCOS | 
program. Prograa interface can be altered further by specifying SHIFT = 
FALSE in the Program section of the Transaction Controt Language. This 
specification changes the manner in which the station name is passed for 
messages frog the MCS. 


Unlike GEMCOS interface» TMCS interface does not utilize the 50-byte 
MCS message header. By this omissions the fotlowing capabilities are 
automatically exctuded: 


ae PARTICIPATION sode. 
b. Audit and recovery. 
Ce Transaction-based routing. 
de Practice mode. 
ee Formatting. 


In TMCS interface» messages on the transactton queue are also of two 
basic types: transaction and administrative messages. 


TRANSACTION MESSAGES. : 

Transaction messages remain the same as those for GEMCOS interface 
programs. Refer to the description preserted previously in this 
sectione | 


ADMINISTRATIVE MESSAGES. 


For programs specified with a SHIFT = TRUE (the default) statement in the 
Transaction Control Language» administrative messages have a SYMBOLIC 
SOURCE field (DC.ORIGIN field for MPLII programs) consisting of MCS. A 
12~byte header containing a station name Cif any) is also present. For 
unshifted programs» the station name is found in the SYMBOLIC SOURCE 
fietd CDC.ORIGIN for MPLII programs) and ro 12-byte header is tncluded. 
There are two administrative message types: MCS control and delayed 
messagese 
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MCS CONTROL MESSAGE. This message is recognized easily ty the asterisk 
and code word for the message type which prefixes each messaYe (i.e.» 
following the 12-byte header itn messages for shifted programs). The 
code word for each MCS message type follows: 

ae *LOGON - togged on via LOGON command. 


be *LOGOFF - Logged off via LOGOFF command or station was 
NOT READY. | 


¢. *AT - attached via AT command. 

de *EX - attached via EX command. 

ee. *RN - attached via RN command. 

ff. *PL = attached vita PL command. 

ge *DT = detached via OT canada. 

he RE - recatted via RECALL command. 

1. *£Q0 = the queue of the executed program has been ailocated. 
: ey #AQ = the queue of the executed program has been attached. 
ke. *VACANT - the last or only station has signed off. 

tL. #*TERMINATE - the MCS is terminatinge | 

ma. *«DTEOJ = the attached program has proceeded to End~ef-Job. 


Following the code word for the LOGON» AT» EX» RN» or PL messages 
user~entered text 1s permitted. 


DELAYED MESSAGE. This message type is a response to an earlter Network 
Controt Command. Depending upon the type of formatting requested when. 
the Network Controt Command was originally transmitted» the delayed 
response wittl be either internally or externaily formatted. I inter- 
nat format is requested» a i2g-btyte header (for shifted programs only) 
will be foltowed by a nutt code CASCII a002)» a 35-byte NDL header» 

and any text pertaining to the Network Controt Command. If internat 
format was not requested» the i2-byte header Cfor shifted programs 
only) will be fotlowed cy FROM MCS» and any text pertaining to the 
Network Control Command. For further detail on the actual text in 
delayed messages» refer to the NETWORK CONTROL COMMANDS section. 
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The first message received by the IMCS interface progran wilt differ in 
format from subsequent messages. This initial format follows: 


(12 bytes) attached station name (ji.e.» the name of the station 
or dummy station which 
has been attached) 


(3 bytes) network control command (Ceeger *RN) 


Cuntigited) user text (from the initiating coamand) 


The SYMBOLIC SOURCE CDC.ORIGIN for MPLII programs) contains MCS. 


The example above concerns shifted progragss. For unshifted programs» 
howevers the initiator'’s name appears instead of MCS tn the SYMBOLIC 
SOURCE field COC.ORIGIN field for MPLII programs). 


NOTE 

TMCS program interface messages are. 

identical tn format on the communicate 

queue to those destined for GEMCOS 

interface programs. Whether the program 

is shifted has no influences neither the 

i2-byte header nor the 50*byte header in 

GEMCOS messages 1s sent to the communi- 

cate queue. Atso»e the SYMBOLIC SOURCE 

field Cor DC.ORIGIN) ts consistently 

MCS. 
The final difference between TMCS and GEMCOS interface is the manner 
in which Network Control Commands are sent to the MCS. Untike GEMCOS 
interface» there 1s no NETWORK CONTROL COMMAND flag» and internal 
format is requested using a nonprintabte character (2002 to @1F2) as 
the first character of the message. 
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MCS OPERATION 


To execute C¥S GEMCOS» users should type the following on the SP). 


EX—— MCSOBJ 


CONFIGURATION 


CC 


“ESBS Pe Teial ized. 
carded. MCS cold-start should be performed whenever station nam?s are 


added or changed in NDL» or when the TCL description of the network is 
changed. | 


RECOVERY causes the MCS to execute in recovery modes 
messages from its audit trail. 


and to redel:iver 


in conjunction with TRACE» .and causes the trace to b2 


SPO is used 
instead of the printer. 


directed to the SPD 
TRACE causes the CMS GEMCOS trace to be enabled aide iniae initialization.e 


Dy RNR DUTIES ENE ALER AE ARLES ESTE BARTERI 


TRACE way_te discontinued using the *TRACE OFF command. 


tp ANAT ERDAS 


A 
WARM specifies an MCS warm-start» and causes the MCS to r:esume execution| 
| from existing MCS files. WARM 15 the normal mode of initiation. 
The default mode of CMS GEMCOS is and both wara=start and tank | | 
jfites_ ‘are assumed to be on disk. Tf the tank file is missing or is 
nconsistent with NDL» a new copy of MCSTANK ts created. If the 
warm=sStart file is missing»s a new copy of MCSWARM is created witn 
| default ICL attributes. If the wara-start file tis preseat but tacks 
an entry for every stations the atsorng stations are add2d to th? 
file with default attributes. 


rH 
f 
b 
ip 


DC CONF causes CMS GEMCOS to request the datacom hardware configuration 
from the SPO. -If the NOLIST option ts specified» the datacom hardware 
configuration is not printed. If NOLIST is not specified» the. 
configuration is printed on the line printers or on the SPO if a 
printer is not available. If the option CC is specified» CMS GESCOS 
requests the datacom hardware configuration from disk file MCSCCIN. 

The remaining records in this file are executed as Network Control 

Cc 

D 
R 


Refer to the CC command in section @. 


ommands. 
C CC causes all records in disk file MCSCCIN to be read and processed. 


efer to the CC command in sectton &. 


| 
| 
| 
| 
| 


SECTION 7 


QVERVIEW OF THE 
NETWORK CONTROL COMMANDS CNCC*ts) 


% om — 


control of the data communica Ton n 


war. 
diadiies 


Other commands are restricted depending 


upon usage. Refer to the individual commands in section @ for 
restrictions. . 


Following are the methods for specifying a Network Control Command 
messagee 


When sending a command to dummy station MCS» a user program may include 
a tag which 15 returned Cor forwarded) along with atl responses and/or. 
notifications resulting from the command. 


The tag is passed in the SKIP field of the message header ty executing 
a SEND (OC SEND in MPL<“1II) AFTER/BEFORE ADVANCING <tag> LINECs3» where 
<tag> is a binary number (decimal in COBOL) from 13 thru 99. The tag 
is returned Cor forwarded) as displayable ASCII in the MONTH field of 
the MESSAGE DATE in the input Commu | Descrip ys #There- 
fores 1f a user program receives a message with a MONTH field vatue 
greater than 12 (3132 in hexadecimal)» it is assumed that the value 

is a tage | 


If the command associated with a user tag 1s a DF <queue"name>/» or a 
DT <queue"name>/NXn»e the sending program is not actually detached froa 
the implied program although all of the appropriate responses and/or 
notifications are returned Cor forwarded) as if the detachment had 
actually taken place. Refer to the DT command in section &. 


COMMUNICATION. CIPC). 

Interprogram Communication CIPC) between dstacee programs 1s 
accomplished using the COBOL or MPL<-I1I send and recetve statements 
with statton names MXnsx where <n> 185 an integer not corresponding to a 
mix number 


Multiple stations of any type may te referenced by specifying an equal. 
sign (=). Although no characters are requireds the equal sign may be 
preceded by one or more characters. Fotlowing are examples using 
stations TO730XA» TD700XBs TC4000A» TD830XA»> and BI347XA.q 


= references alt stations 

T= references TD730XA» TD700XB» TC4O000As» and TODB359KA. 

TD= references TO730XA» TD700XB» and TDB3OXA. 

TO7= references TO/30XA and TD70GXB 

TO73= references TD730XA. 

TO? 30X= references TD730XA. 
In the signtae diagrams for the commands» <station=name> indicates a 
Singqie station name only Ce.ger» TDB30XA) while <station-f amily> 


indicates a single statton name (e.ge» TD730XA) or multipte station 
names Ce .Ger TD739X A» TDO700XD» TOB30=.22)- 


There are three types of 
declared in NOL: 


which may be 


The statitonvuntque queues. are intended for the 89347 CODE) stations 
ontys» on a one~to~one basise and are interded to be accessed by the 
respective station onty. St ; 


rning. 


for retu 


: 


ot. 


in d 


<lin>s: 


<isn>33:= 


ul 


<lqn>s: 


<lpn>s°s 


i} 


<ltn>:: 


e 
il 


<lan>:: 


A 
@ 
est 
« 
Vv 
es 
ee 
A 


es are available using the commands. Refer to the 


‘cogmands in section @. 


A literal string tay be graphic or hexadecimal or both. It may appear 
as output by extternalty formattec OL responses» or as input using the 
Alt hexadecimal strings appearing as output from 
the CL» FL» or RS commands» may be followed by a stash and a subsequent 


BL 


graphic string (€e.genw 2A/* or 24/8). 


in 


yn. Ce. 


the 


The. TQ» 


and RS commands. 


section 8. 


ge “A™). 


NQ» and the ASSI 


"A Literal string required as input may te entered as a hexadecimal 
istring or a graphic string but the two forms may not be combine 


Ss 


Refer to the RL and RS commands 


de 
. 


GN and EX commands may be entered without a. 


be The following chart Lists certain reserved words» which» when 
imply the use of one of the commands. 


y appear atone» 


Reserved wvAords 


Japlying TO 


ALL 
SPO 

5 
STATIONS 


/ 


<station-famil y> 


Reserved words 
Jmolying ENG 


It 
IC 
OL 
OC 
QL 
Qc 
SL 


sc 


Reserved words 
LTaplying ASSIGN_or_£—X 


<program ndme> 


<mi x> 


A <program=name> may contain any number ard any combination of 
letters ang digits and/or special characters. The conditions for these 
combinations are as follows. 


b. The combination must be allowable in the CMS EX statement. 


ce If the combination is not preceded by ASSIGN» EX» RN» PL> or 
AT it may not consist of the following: 


1) The reserved words ALL» SPO» S» or STATIONS. 
2) A singte stash (/) or equal sign (=). 
3) An NDL-defined station-name. 


&) Qne of the following mnemonics: IL» IC» GL» OC» QL» OC» 
SL» or SC. | 


5) A <mix> Cif entered at the SPQ). 


Following is an outline describing use of the Network Control Commands. 


(1) ASSIGN or EX commands. 


@)» RN (Run) command. 
3) PL (Program Load) command (must be specified by DDE). 


(ay AT CAttach) command... 


b. 
1) Detach terminal from prograa using the CLOSE or DT 
CDETACH) commands. (The programmer has the option of 
establishing a convention that» when the last terminal 
1s detached» the programa is discontinued.) 
2) STOP cogmand. 
Ce 


1) STATUS command. 
(2) )MX (Mix) command. 


3) PR Caesicn Priority) command. 


1) TRACE command. 


2) GY (Get Trace) command. 
3) NT CNo trace) command. 


4) $0 (Set Option) command. 


t>) CF CControlting Function) command. 


2) PRACTICE co@mand. 


1) BREAK command. 


1) CONF (Configuration) commande 
2) RL (Redefine Datacom line) command. 
3) RS (Redefine station) command. 


4) RD (Redefine or Retoad DCP) command. 


re -ercencchete SIAR TARE ENO NON TT 


/2)) OL (On Line) command. 
* eS 


RY (Ready) command. 


ers NY (Not Ready) command. 

5) FI CEnabte Input) command. 
6) ODI (Disable Input) command. 
7) DIALIN command. 

&®) OLALOQUT command. 

9) DISC (CDISconnect) command. 


19) AP3OOSTATUS command. 


Ce 


TO command. 
SEND command. 


TEST command. 


STOPTEST command. 


WMY CWho Am I) command. 


1) 


2) 


3) 


1) 
2) 
3) 


4) 


LOGON command. 
LOGOFF command. 


CHANGE command. 


CL (Clear) command. 


DETANK command. 
RE CRecatl) command. 


RESTORE command. 


‘ad 


1) HALT command. 


TERMINATE command. 


1) LL (List log) command. 
2) LC CLOG Comment) command. 
3) LT CList Tables) command. 


4&4) DUMP command. 


Ce 
1) SO (Set Options) command. 
2) RO CReset Options) command. 
3) LO (List Options) command. 

de | 


WRU (Who Are You) command. 


f. GEMCOS FORMATTING. 


1) MERGE commande 


G8 


ae MCSLOGON (MCS Log On) command. 
be MCSLOGOFF (MCS Log Off) command. 


ce MCSRUN CMCS Run) command. 


de READMESSAGESQUEUE (Read Message Gueue) command. 


SECTION ® 


 Fotlowing is a discussion of each of the Network Control Commands (NCC's). 


ASSIGN_AND_EX_ COMMANDS» 

The ASSIGN and €X Cexecute program) commands are used to create dynamic. 
program attachments. Attachments may be created between a signed-on 
real station and a datacom application program (with valid assigners)>» 
or tetween a dummy station (SPOQ» program or disk file) and a datacom 
application program. The syntax of the ASSIGN and EX commands is 


provided below. 


<program=name> 


me<disk-id> / <program-name > 


— ional fields 


<mix> / <program=name > 


<mix> 


The specified (or default) station(s) is attached to a program if the 
fotlowing conditions are met. 


as The requested program is currently running with the specified 
Cor default) <queue“name>-» 


b. The maxinum number of assigners for the requested program is 
not exceeded. - 


ce The assigners are authorized to attach to the requested program. — 
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If the requested program 1s not running» or if the maximum numcer of 
assigners is exceeded» anew copy of the program may be initiated, 


Following a successful ASSIGN or EX to a real stations» the real station. 
is permanently tinked Cattached) to the requested datacon program. 

This program receives ati further input messages from the Station» with 
the exception of Network Control Commands (NCC)sS which are sent 
directly to the MCS. , 


The ASSIGN and EX commands cannot be addressed to a concentrator or 
Hoste | | 


if €X or ASSIGN is omitted» GEMCOS assumes an implied EX. 


A specified <disksid> must be the name of a valid disk pack. if the 
<diskeid> is omitted» the system pack is assumed. | 


If mix number is omitted» the EX command attaches the requestor to the 
<program™name> to which the maximum numter of assigners has not been 
exceeded. | = 


The <optional fietds> field is implementation dependent and indicates 
the magnitude in bytes of the immediate access storage (core memory,s 
random excess memory» etce) which 18 required for efficient execution 
of the programe QIne set of angled trackets 1s necessary to enclose the 
text portion of option fields. Refer to the Computer Management 
Systems (CMS) System Software Operation Guides form number 2697258. 


If <queue"name> is specified» it must te the name of a valid subnet queue. 
A search is begun for a copy of the requested program with <queue"name>. 
If such a copy 1s founds the requestor is Linked up with it; otherwise» 
a copy of the requested program is initiated» having assigned to it 
<queue=name>. <Queue=name> is used by GEMCOS as a transaction queue. 

If <queue=name> is omitted GEMCOS atltlocates the first. available general 
subnet queue. | 


Tf the reserved word NEW/ is entered in place of the <queue-name>/>» a 
new copy of the requested program 1s tnitiated (using an available 
general subnet queue). 


If <integer>/ is specified» a search is begun for a copy of the requested 
program with <integer> transaction aqueves and fewer than the maximun 
number of assigned users. Jf such a program 1s founds the requestor is 
linked with it» otherwise» a copy of the requested program is initiated» 
having assigned to it -<integer> transaction queues. 


If the integer <integer NEW>/ is specified» a new copy of the requested 
program is initiated having assigned to it <integer> transaction queues. 


ASSTGN AND EX COMMANDS 


CONT 


If / is specified» all available stations comprising the specified 
Cor default) subnet queue are attached. Refer to the FILE section of 
the CMS Network Definition Language Feference Manuals form 1090925. 
If there 1s not at least one station avaitarle for attachments or if 
the requestor 1s not a controller (i.e.» a control program or control 
station)» the request is rejected and an error message is given. 


If = 1s specified» alt stations comprising the specified Cor defautt) 
subnet queue are attached. Fefer to the FILE Section of the CMS Network 
Definition Language Reference Manuals form 1990925. If one or more 
Stations are currently attached to a different program/queue Ce.ger not. 
the requested copy of the program)» the request is rejected and an 

error message 1s given, 


if a <queuesname>/ and <station"family> are specified» all available © 
specified stations comprising the specified subnet queue are attached. 
An error 1s reported if all specified stations are not available. 
Refer to the FILE section of the CMS Network Definition Language 
Manuals form 1990925. 


If a <stationsfamily> is specified without a specified subnet queues 
all available specified stations (that exist on the REE MOLE are 
attached. 


If the execute request CASSIGN or EX command) is entered from a progran 
to which one or more of the specified stations are currently attached»s | 
those stations are iamediately detached from that prograg and are | 
attached to the specified <program*name>» If a station is currently 
attached to the specified (€or default) subnet queue» a detach is not | 
per formed since the station is already attached to the specified queue. 


lf the execute request is entered from a real station which is not a 
togded“on control station» /» =» or <station-family> may not be 
sp&cifieds. OnlY to98ed=on control stations may attach a station other 
than themselves. | 


For each currently attached station Ceither the default statton or 
Stations specified in station list) the TCL program section attribute 
REASSIGNUK 15 examined to determine if the currently attached station 
may tecome available for this new attachment Ceege» if REASSIGNOK = TRUE. 
a station becomes available» if REASSIGNOK = FALSE a station does not 
become available). 


If the execute request is entered from a SPO» CC file (Control Command) 
or a user datacom programs» then»e in addition to the speci fied real | | & 
station the name of the dummy station corresponding to the SPO» CC file» @ 
or initiating program (DC» CC or MXn respectively) is implicitlhy attached 
to the initiated program. If a GEMCOS interface program is executed . 
from the SPO» and no stations were specified Cin the execute request)» 
the program receives a sign”on message from dummy station OC. | 

Subsequently,» if the initiating program goes to end*of"jot» its 

corresponding dummy station 1s detached from ait sutnet queues. The 
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SPO » CC filer or initiating program may detach itself from a queue via 
the detach (DT) <queue-name> message. Refer to the DT command in this 
section, Untess the initiating program goes to endtof-job» or unless 
the SPG» CC file or initiating program detaches itself from the subnet 
queue of a program which it has initiated» the initiating program's 
subnet queue never becomes vacant (void of attached stations) even if 
all of the real stations detach themseives. 


if the optional word NOACK is specified Cin etther the EX command or 
in TCL)» the valid response(s) is not sent to the specified/default 
station(s). <Aiso the detach indication is not sent when a station(s) 
is detached. Refer to the DT command in this section, 


If the optional word LOGONALERTS is specified (either in the EX 
cogmand or in TCL)» the program is notified of users logging=on and 
loggingtoff at real stations. Refer to LOGON or LOGOFF in section 7. 


Since LOGONALERTS and NOACK are reserved words within the ASSIGN and £X 
commands» the following syntactically correct examples should ce 
avoided. 


_a@e €mix#> / LOGONALERTS 
hb. <<mix#>/NOACK 


Specifying the examples (a. and bt. above) means atl available stations 
wilt be attached (i.e.»5 / ) to program <mix#> specifying LOGONALERTS 
or NOACK. As a detours specify the program name associated with 
€mix#> as follows. | 


ae <mix#>/<program=name> / LOGONALEFTS 
be <mix#>/<program™namne> / NOACK 


If any EX command characters remain in the execute request» they are 
assumed to be user text» and are appended as part of the sign™on message. 
The optional = indicates that what is to follow is user texte» 


If the execute request (EX command) is vatid» the following occurs: 


ae If the requested program/queue combination is runnings and 
NEW/ WaS not specified» the specified/default stations) is 
attached to the requested program. Otherwise a CMS EX state 
ment is ZIP“executed by GEMCOS and the specified/default 
Station(s) is attached to the new programe This CMS EX state- 
ment appears as follows: 


EX <Program, transaction, communicate, dummy | 
Tame queue name queue name station (MXn)7 


be 


EX COMMANDS | 


ASSIGN AND 


NGOTc 
The n in the dummy station name» MXn> 
does not necessarily correspond to the 
mix number of the initiating program. 


For each specified/default station» including dummy stations, 
a sign-on message is placed on the initiated program's trans- 
action queue. The format cf the message for a GEMNCOS 
application program is as follows. | 


GEMCOS header with 


< MCS ASSIGNED byte set to @31@7> < station-name > 


For TMCS» the format of the message is as follows: 


<station-name> *EX text 


ALL real stations that become attached with NOACK not 
specified» receive a message in the following form. 


FROM MCS: <mix > / < program-name> <queue-name> OK 


If the execute request is entered from a real station» CC 
file» or SPO (i.e.» not a program) then a vatid response is 
returned in the following form. 


EX 


ASSIGN = 126? 


FROM MCS: 
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If the execute request is entered from a program» a response 
is returned on the initiating program's communicate queue 
(CQ)>» prefaced by a 3-byte fetch value (a59XxX092) in the 
following form. | 


FROM MCS: <MIX> / <program-name> <queue-name> OK (126) 


If the execute request is entered from a program and is 
successfully executed, the symbolic Soufce fietd CDC GRIGIN) 

of the ASSIGN OK message on the initiating program's Communicate 
Queue (CQ) ts the name of the dummy station (MXn) assigned to 
the initiated program. If the request is unsuccessfully | 
executed» the symbolic source field equals the name MCS. Upon 
completion of a successful CMS ZIPsexecutes an Enabte Queue 

(EQ) message is placed on the initiating program's transaction. 
queue. 


For a GEMCOS application program interface the-EQ Message is 
in the fotlowing form. 


GEMCOS header with  . dummy station of 5 
MCS.EQ byte set to @31@ initiated task (MXn) 


For a ImMcsS application program interface the £Q We Sesgs is as 
follows: : 


<dummy station of initiating task (MXn)> *EQ 


The initiating program may send messages to the initiated 
program via its assigned dummy station» MXne The initiating 
program's Output Count (€9C) 1s not decremented on sends to 

the initiated program until the initiated drogram compietes its 
first receive from its transaction queue. This may cause 
suspension of the initiating program since the Output Count 
(OC) may exceed the Output Limit (OL). 


Ce 


de 


< dummy station of 


ASSIGN AND EX COMMANDS 


If the execute request is entered from a programs an Attach 
Queue (AQ) message 1s placed on the inittating program's trans” 
action queue when the initiated program performs its first 
receive on its transaction queue (the first receive may 


_ already have been done for an existing program). This attach 


queue message is in the following form for a GEMCOS application 
programe oa 


- GEMCOS header with >< dummy station of 


MCS.AQ byte set to @31@ initiated task (MXn) 


For a TMCS apptication program interface the AQ message is as 
follows: | | i 


| * 
initiated task (MXn) AQ 


Once the Attach Queue (AQ) message 1s received» the initiating 
program may send messages to the initiated program via the | 
Initiated programs assigned dummy station» MXn. The initiating — 
station's Qutput Count (0C) is decremented properly. If the 
initiating program has already sent one or more messages to 
the initiated program» its Output Count is decremented 

accordingly when the Attach Queue message is received. 


The initiated program may go to end-of“job before receiving 
messages from itsS tfansaction queuee When this occurs a 
Detach End-Of-Job (COTEQU) message is placed on the | 
initiating program's transaction queue. This message 1s in 
the following fora for a GEMCOS application programe ae 


GEMCOS header with >< dummy station of task that 5 
MCS.DTEOJ byte set to @31@ went to end-of-job (MXn) 


For TMCS the message is in the fotlowing fora. 


< dummy station of task that, ,noro; 


went to end-of-job (MXn) 
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When a datacom program goes to end-of=jot alt attached programs 
receive the Detach End*Of-Job (COTEOJ) message. If the 
initiating program sends one or more messages to the initiated 
programs tut the initiated program goes to endeaf-job without 
receiving from its transaction queues the initiating program's 
Output Count (0C) is decremented accordingly. | 


ee If the execute request is invatid» or is valid tut an error is 


encountered during processing» an appropriate error response 
is returned. 


Following are examples of how the ASSIGN and EX commands may be used. 
Refer to the syntax dtagram, 


Examples: 


T 


“a 
rr 
oe) 


DEMO.CONTROL = 

TD.SCREENS TD= 

TEST / _ 

TEST FILEL/ | 

EX PACK/FILE FILEZ/TD7=» TD80G0 USER TEXT 
DEMG FILE1/= NOACK 

ASSIGN DOMSPECREATE 1NEW/ 
“ASSIGN 3/DOMUNIVERSAL 


RELATED COMMANDS. , 
The following commands are associated with the ASSIGN and EX comamands. 


ae AT command. 
be CLOSE command. 
Ce. DF ComBand. | 
de PL command. 
eC. RN ORR Anes 


R=8 


AP3GOSTATUS COMMAND 


AP3QCOSTATUS COMMAND. | 
The AP3OGSTATUS comaand allows the user to request the status of an 


AP300 datacom printer. The syntax of the AP300STATUS command is 
provided below. 


AP300STATUS COMMAND: 
AP300STATUS <Station a es ee 
aren | <text> 

<Station name> and <lsn> refer to the AP300 station being requested. 
When issued the AP3SO0STATUS command returns a message describing the 
status of the AP30G. If the command is tssued by a program requesting 
the message in internal format a 4&4-tyte AP390 description is returned 
to the program. Refer to the AP300 Equipment (Data Communications 
Interface) Reference Manual» form 1119153. If internal format fs not 


requested the message 15 returned in external format. 


NOTE 
The AP30G datacom printer must be 
specified in TCL. Refer to the CMS 
Transaction Control Language CTCL) 
User*s Guides form 1114634. 


Following are exaaples of how the AP300STATUS command may be used. 
Refer to the syntax dtagram. 


Examples: 
AP3GOSTATUS STATION 25 
AP3OOSTATUS S 12 
AP3OOSTATUS MYAP300 


There are no related commands. 
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AT COMMAND 


/AT_COMMAND. — | 

The AT command allows a station» programs CC file» or SPO to become 
attached to an extsting user datacom program. The syntax of the AT 
command is provided below. 


AT COMMAND: 
| SAT. - <program-name > 
— <mix > / <program-name > 
— <mix > | | 
| , <queue-name >/ 
<integer > / 
<queue-name >/ - 
NOACK—— <text > 


: text > 


<station-family > 
If <queue-nane> 1s specified» it must refer to a valid transaction 
queue assigned to a program currently executing. | . 


If the optional <integer>/ is speci fieds a copy of the specified 
program having <integer> transaction queues assigned to it» is sought. 


The at command works Like the ASSIGN and EX commands with two exceptions. 
uaeee two exceptions are as follows. 


ae <A new copy of the requested programa is never initiated» 
instead» an error is returned tf the requested program/ queue 
coatination is not present. 


be For TMCS interfaces a sign-on message of *AT instead of #EX is 
queued on a programs transaction queue. | 


pebtouine are exaaples of how the AT command may be used. Refer to the 
syntax diagram. 


Exaaples: 
AT DOMUNIVERSAL 


AT JEFFNCCOBJ FILE3/ = NOACK 


AT COMMAND 


cont 


RELATED COMMANDS. | 
The following coamands are associated with the AT command. 


ae ASSIGN and EX commands. 
be. CLOSE command. 

ce. OT command. 

de PL command. 

@e RN command. 


BREAK COMMAND 


BREAK _ COMMAND. — | | 

The BREAK command attlows the user to interrupt an executing prograag. 

The MCS places a message on the prograa’s communicate queue. The syntax 
of the BREAK command is prowided betouw. | 


BREAK COMMAND: 


——~ BREAK 


<text > 
> <text > 


if a break request (BREAK command) is valid» a break message is placed 
on the appropriate communicate queue. This message is in the following 
for@e 


CFFFFFF@<station-name>? “BREAK text 


The <station-name> contains the actual or dumay nase of the sender» 
(space filled to 12 characters). Since the communicate queue is not 
cleared until the program receives the break message» or until the 
program goes to endrof-jobsr a program should be ready to process a 
pee en. message whenever the CQ is betng read. 


‘To avoid sending a break message to a program which is unabte to process 
it» a flag calied BREAKALERTS is inctuded in TCL. This flag is : 
associated with a program description and must be set to TRUE if a 
program ts to be allowed to receive a break messagee If the BREAK 
command is issued for a program which does not have the 3REAKALERTS flag 
set to TRUE» an error message is returned. Also» tf the BREAK cammand 
is issued for a program which already has a break message on tts 
com@unicate queues an error message is returned. 


If the BREAK command is entered from the SPO» CC file or a programs the 
optional cmix> must be specified. If the SPO or program is not a 
controller» it must have previously attached the primary transaction 
queue of the program running at the specified mix number. 


If the BREAK command is entered from a station which is not a 
controller» the <mix> may not be specified and the terminal must be 
attached to a program. Control stations may send a break message to a 
program by specifying <agix>. 
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BREAK COMMANDO 


cont 


Following are examples of how the BREAK command may be used. 
the syntax diagram. 


Examples: 
BREAK 
BREAK 2 FILE1 


The BREAK command is not associated with any other command. 


Refer to. 


CC. COMMAND. 


The CC (Control Commands) command giioes the user to enter a series of 
Network Control Commands (NCC's) using a Control Commands (CC) tnput disk 
file. The syntax of the CC command is provided below. 


CC (CONTROL. COMMAND) COMMAND: 


——-CC “t ef  * =. | 
| a 7 


The CC command is a restricted Network Controt Command and therefore 
may only be issued by a controt program or a control station. 


The CC input disk file may be any sequential file. CMS CANDE offers. 
the siaptest method for creating and building this file. The input 

file should contain Network Control Commands and their syntaxe Each 
entry tn the file must end with a semicrcoton and must occupy a separate 
record. Any Network Controt Command with the exception of the CC 
comaand may be included in this file. The CC file is considered to te 

a controller when issuing Network Control Commands. 


The syntax allows the user to specify the CC input file from which the 
commands are to be read. A CC output file is opened on the disk cone- 
taining the CC input file. Default attributes for the CC file are 

as follows. | 


Input CC File | Default 
DISK=ID | €000000 
FILE-NAME | MCSCCIN 
Qutput CC File Default 
FILE-“NAME | MCSCCOUT 
FILESTZE 512 


These aticibutes may be specified in TCL in order to change the default 
values. 


GEMCOS opens the CC input file and begins reading and processing 
commands froa the input file untit an end-of-file or an error condition 
ts encountered. For each coamand being processed» a copy of the commar 
along with the MCS response to the commands is written to the CC Outpu 
file CMCSCCOUT). When the output file BECOAGs full» the next entry | 
writes over the first entry. 


in order to use the CC command» a dummy station named CC must be 
declared in the Network Definition Language (NDL) program. 


CC COMHMAND 


cont 


Program itnitiation/attachment initiated by the EX» ASSIGN» RN» PLe and 
AT commands contained in a CC input files» produce sign-on messages 

from the dummy station CC. GEMCOS records the attachment between the 
user program and the dummy statton CC so that the user program may send 
messages to dummy station CC. Messages sent to the dummy station CCe 
are recorded in the CC output file. If there is at least one out 
standing program initiated from a command in the input files» the output 
file remains open. In addition to sending messages to dummy station CC» 
aouser may detach the duamy station CC from its transaction queue. 

Refer to the DT command tn this section... 


The CC output file is a sequential file with a record size of 132 bytes 
and a buffer size of 132.2 A new output file ts opened for each CC 
command unless an output file has remained open tecause of an out= 
standing programe If there is an output file opens the CE input fite 
must be on the same disk in order for the Control Coramands to be 
successfully executed. The new Controt Commands use the existing open. 
output file. The output file may be tisted with the System Control 
Language (SCL) LIST UTILITY command. | 


The CC command may be entered as part of the tnitiating message to 
GEMCOS in the following fora. 


as ns Bae 
| - CONF 


If CC is entered as part of the initiating message» the first records in 
the CC input file should contain the DC hardware configuration Cif the 
MCS requires network reconfiguration). Refer to the CONF coamand in 
this section. Once MCS tnitialization is completed» any unprocessed 
commands in the CC input file are read and executed as part of a. 

CC coagmand. 


‘When entering the CC command as part of the initiating message to the 
MCS» a <file-nagme> may not be specified. The MCS uses the values 
specified in TCL» or if values were not specified in TCL» the default 
values. . | 


CC COMMAND 


cont 


Following are examples of how the CC command may be used. Refer to the 
syntax diagram. | 


Examples: 
cc 
CC GEMCCS.IN 
CC DEVELOP/TESTER 


RELATED COMMANDS. | 
Atl of the Network Control Commands are associated with the CC command. 
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CF COMMAND 


e  COMEsna (Controlling Function) aliows a user to become or to 
clear the controlling function of datacom resources such as lines» 
stationss or datacom processors. A controltiing function is a prograa 
which has become a controtter for a datacom resource. The syntax of 
the CF command is provided below. : 


CF (CONTROLLING FUNCTION) COMMAND: 


“Vecie’ Coes 
<7>— ——SPO - 


—~ EXCLUSIVE 


<station-family > 


- ERROR — ATTACHED 


The <?> Coptional) represents a nondispfayable character (3002 thru 
@iF2). If <?> is present» responses from GEMCOS are in internal format. 


If SPO is specified» the initiator must be a program or a controller. 
attempting to clear the current controtling function of the specified 
datacoa resources. Uf the initiator is a controttler and the current 
controtting function is not exclusives or if the initiator is the 
current controlling functions the execution is successful. 


If a progras entered the coamand without specifying SPO and tf the 
resources do not have current controtling functions» the program is 
assigned as the controtting function of the specified datacom resources. 
If EXC or EXCLUSIVE is specifieds the program is assigned as the con= 
trolling function of the specified datacom resource exclusive of the 
controllers. Therefores a controlling function program becomes just 
another control program for the specified resources but an exclusive 
controiling function prograa becoges the onty controtiter: for the 
specified resource. 


Multiple resources gay be specified in the same request (Cas indicated 

in the syatax diagraa)d. If more than one type of resource 1s specified» 
ali resources of the same typ2 must be specified before going on to the 
next type. The types of resources must appear in the order shown. An 
error detected in one resource type terminates the request» however» 

it does not invalidate the assignnents already made in the same request. 
An error message is given if no resource type is specified. 
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CF COMMAND 


cont 


If ERR or ERROR is specified» message headers associated with nonfatal 
(successfully retried) errors» as welt as message text associated with 
fatal errors are reported to the CF programe. When a message containing 
header inforration is received» the messace Cif any) containing text 
information is the next message in the queue from that station. 


If ATT or ATTACHED is specified» the CF program is notified of alt 
attaches/detaches of the associated station with any program other than 
the CF program. Refer to the AT command in this section. 


When a CF program goes to end-of-jobs its position as a controlling 
function of any datacoa resources is automatically cleared. 


Foltowing are exaaples of how the CF command may be used. Refer to the 
Syntax dtagrame 


Examples: | 
CF TD830= ERR 
CF DCP Or 1 LINE 3 TD830XA 
CF SPO L 6» 7» 8 = 


RELATED COMMANDS. 
The following commands are associated with the CF command. 


ae NY command. 

b. AT command. 

ce NT command. 

de RS command. 

@e RY command. 

f. ASSIGN and EX commands. 
ge CLEAR command. : 
he. RD command. 

ie SET command. 

j- OT command. 

ke RN command. 

1. DETANK command. 

me RECALL command. 

ne CLOSE command. 

oO» PL command. 

pe GT commande 

ge RL command. 


CHANGE COMMAND 


CHANGE COMMAND. 
The CHANGE ccmmand ts used to change an access~key/password 
combinatian.e. The syntax of the CHANGE command is provided below. 


CHANGE COMMAND: | | | | 
-— CHANGE ACCESSKEY <access-key > Too. TO <access-key > |... | 
| 7 7 / <password > a | / <password > | 


The CHANGE command is used to change existing accesskey and password 
identifiers white the MCS is running. Alt changes are recorded in the 
MCS wareanstart file. The changes are saved when the “CS is 
remexecutede 


If an access-key has a password associated with it» both must be 
presented in order to make a change. If a new password is not 
specified» the old password is dropped. 


In order to enter special characters» access tkeys and/or passwords may 
be entered in quotation marks. | 


The CHANGE command is a restricted Network Controt Coamands and 
therefore may onty be executed by a control station» a controt progres 
or the cc file. 


Following are examples of how the CHANGE coamand may be used. Refer to 
the syntax diagram. 


Examples: 
CHANGE ACCESSKEY MY/PASSWORD TO MY/PWD 
CHANGE ACCESSKEY MY/PASSWORD TO MY 
CHANGE ACCESSKEY MY/PASSWORD TO YOUR/ “PASS = WO" 


RELATED COMMANDS. 
The following commands are associated with the CHANGE command. 


ae LCGCFF command. 
OD. LOGON command. 
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| CLEAR COMMAND 
CLEAR COMMAND. 


The CLEAR command removes Bess age> eee ae 
station or subnet queugs 7 a | a 
“provided belcw. ; : 
ele Medsinte tmeni eto 

CLEAR (CLEAR MESSAGE FOR SPECIFIED STATION/SUBNET QUEUE) COMMAND: 


preeecrtewen| 


— CLEAR 


STATION <isn > 
<station-name > 
QUEUE <Iqn > 
<queue-name > / 


If a station queue is being cleared» that station*s tanked messages are 
removed. | 


If the CLEAR command ts entered at a noncontrol. stations only that 
station may be cleared. 


If the CLEAR command is entered from a norcentrol programs onty 
stations and queues attached to that program may be cleared. Aiso any 
station of which that program is the controlling function may be cleared. 


Following are examples of how the CLEAR command may be used. 


CLEAR S 9 

Ci TOS30XA 
Ci 2 

CLEAR FILES 


RELATEO COMMANDS. 
The following commands are associated with the CLEAR command. 


ae DETANK command. 
be RE command. 
ce RY Command. 
de NY command. 
ee RD command. 
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CLOSE COMMAND 


CLOSE COMMAND. | 


The CLOSE command is used to detach an attached reat station or a List 
of real stations. The syntax of the CLOSE command is provided beatox. 


CLOSE COMMAND: 


<station-family > —— 


If station list is omitted» the close request (CLOSE comaand) detachs 
the sender. Noncontrot ‘Stations way close onty themselves. 


Attached programs are notified of a ctose through a message on the 
prograam’s transaction queue of the fotlowing foram for GEMCDS. 


<GEMCOS header with MCS.STATION.CLOSED byte set to @31@><station-name> 


For a TMCS interface the message appears as foltows: 


<station-name> *DT 


if the subnet queue to which a station is attached becomes vacant (last 
or onty stations including duamy stations» has become detached)» GEMCDOS 
notifies the prograa by sending the fottlowing message on the Peoerayne 
transaction queue. 


<GEMCOS header with MCS.VACANT byte set to @314@> 


For a TMCS interface the message appears as foltows: 


<12 blank characters>*VACANT 


Following are examples of how the CLOSE command may be used. Refer to 
the syntax diagran. 


Exaaples: 
CLOSE 


CLOSE TDB83S0XA» TD83OXB 
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CLOSE COMMAND 


cont 


FELATED COMMANDS. 
The following commands are associated with the CLOSE command. 


a. ASSIGN and EX commands: 
bh. AT commands 
ce DT command. 
d. PL command. 
Qe RN command. 
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CONF COMMAND 


The CONF (Configuration) command is used to list and/or change the 
datacom hardware configuration (Cor SITE file). The syntax of the CONF 
command 15 provided telow. 


_ a 
L__ NoList — - | 


NETWORK UNITS. 

The CONF command produces a listing of the current datacom hardware 
configuration, followed by the message ENTER DC HARDWARE CONFIGURATION, 
If the option NOLIST is soecified» the DC hardware configuration is 

not printed. If NOLIST 1s not specified the DC hardware configuration 
is printed on the printer or SP9 if a printer is not available. The DC 
hardware configuration aay then te entered in the form of network units. 


The format of a network unit 1s as fottlows: 


—<line no. > <station-family > 


<speed > 


When a network unit 1s entereds the specified stations are configured 
onto the specified line. If the optional speed is specified, ait 
$tations are adjusted to that specified speede If no speed is spec 
ified» the speed of the listed station with the smattlest togicatl 
station number is used» and alt other stations are adjusted to that 
speed. 


In addition to Network Units» the FL and RPS commands may te entered to 
further specify the network. Also» the SO» KO and SET commands may ce 
entered to have runtime options and queue timits saved tn the MCS Site 
Network Informatton File CMCSITENIF). The NY and FY commands may also 
pe entered to further specify the network. Simply indicates at 
initialization» that the station or tine 1s to ke made ready or not 
ready. If a Station is specified in the RY or NY comuand it witl also 
be made ready or not ready whenever any task detaches from that 
station. kefer to the RL» FS» SU» RU» RY». and SET commands in this 
section. | 


wy Pan 
gee ? 


CONF COMMAND 


cont 


When the CONF command is used» the MCS Site Network Information File 
CMCSITENIF) 18s created by GEMCOS. This file is Subsequently used at 
initiralization by the MCS for datacom hardware configuration. 


If no MCSITENIF exists» or if the MCSITENIF does not describe the same 
network as the current Network Definition Language Systen (NDLSYS) files 
the CONF command 1s automatically calited during initialization of the 
MCS. Additionalty» the CONF command may be explicitly catled at 
inittalization by Specifying DC CONF as an initiating option. If DC 
CONF 1s specified» the hardware configuration may be entered at the 

9PQO~5. The hardware configuration may also te entered from a disk fite 

at initialization using the CC (CControt Command) file. Refer to the CC 
command in this section, — hs 


——~ EX —— MCSOBJ 


pc 


CONFIGURATION —-~—————| | NOLIST 
| bell 


ce 


The CONF command is a restricted Network Control Commands and therefore 
may only be issued from a controt stations a control program» a 
controlting function or the CC files Onty one CONF command may te in 
progress at any time. 


When the first network unit is entered» the network is configured to 

the current MCSITENIF fite if one exists. Alt stations are then removed 
from the Lines. As network units are entered» stations are moved onto 
lines as the network units dictate. 


If an error %1$ encounterd while processing a network units» all stations 
are removed from tines and the message ENTER DC HARDWARE CONFIGURATION 
is repeated. 


The 8 69 or 8B 99 systems do not support dynamic reconfiguration. 
Station attritCutes cannot te woved on or offelines. Instead of moving 
stations» they are marked absent Cnot ready). When network untts are 
entereds the stations are marked present (ready). 
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CONF COMMAND 


BUILD/MODIFY SITE PHONE DIRECTORY. 

After the END Cmentioned under NETWORK UNITS) 18s entered the message 
ENTER DIRECTORY BUILDER? CY or ND is displayede- If N is entered the 
routine is terminated. If Y is entered the message 3UILI NE 
DIRECTORY? CY or N) is disptayed. To build a new directory the 

user should enter Y. To update an existin9 directory the user 
should enter N. 


After the user enters Y or N the message ENTER REMOTE SITES ts dis- 
played. The user may enter remote sites as follows: 


<site-id> —— . nem Line <network unit> 


(N) <phone number>-— 


<Sitetid> is the name used to identify the remote site. The name must 
begin with an alphabetic character and may not exceed i? characters. 
Specifying only <site-id> indicates the entry is to be deteted. To 
update a site the full description of the site must be entered. (N) 
indicates a nonstandard site. 


NOTE 
If a nonstandard site is specified it is 
excluded from the line when it i135 con" 
figured to the default TOTAL/SITE 
configuration. 


<Phone number> is the phone number of the remote site (ug to 15 numeric 
Characters). <Network unit> is described under NETWORK JNITS. 


The END command terminates the procedure. 


During initialization atl stations are moved off of each tine that is 
represented in the site phone directory. Each line 1s configured so 
ait stations associated with a standard site are attached to that Line. 
This ts catled TOTAL/SITE configuration. — 


Each nonvacant tine is made ready unless the MCS (during initial 


network configuration) was instructed to leave the line not ready 
Cusing the NY L <ttn> command). 
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CONF COMMAND 
cont 


FOtloWing are examples for the remote site entry syntax. 


DC SITE1L 2698492 LL 3 1253 TO7E2K4» TDI35X3 
DC SITE2 (N) 2691245 L 1 483 TOB3CXAs TOK3EXB. 


DC END 


Following is an example of how the CONF command may te usede Fefer toa 
the syntax diagraan, | 


CONF 

1. 4€00 TO835XB 

0 TO7= 

FS 24/TDES$9XA ADR=™BAM 
$0 COLOG 

END 


RELATED COMMANDOS. | 
The following commands are associated with tne CONF command. 


ae RL command. 
t. FS command. 
ce RO command. 
d. SO command. 
@e SET command. 
f. NY command. 
Ge RY conmand. 
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DETANK COMMAND 


DETANK COMMAND. 
The DETANK command deletes or recails messages from a ee oertied 
station's tank. The syntax of the DETANK command is provided below. 


-DETANK <station-name > ee | | | 
| SPO ALL a 


If the TO <station-nasme> or TO S$P0 clause is selected» detanked sessages 
are displayed at the specified destination before being deleted froa 

the tank. If the TO <station-name> or TO SPO is not selected» messages 
are deleted without being displayed. | 


If <integer> is specified» the oldest <integer> aessages are detankec. 
If ALL is specifieds then all of the station's messages are detanked. 
The default value for <integer> is lL. 


fhe DETANk command is a restricted Network Control Command» and there- 
fore nay only be issued from a control statione a control programs the 
penne rn ey Hyeen ene of the station being detanked> or the CC fite. 


Following are examples of how the DETANK command may te used. Refer to 
the syntax diagrams. | 


Exasoles: 
DETANK TO&3Q0XA 
DETANK STATIONS ALL 
DETANK 8 TO A 


RELATED COMMANDOS. | | 
The following commands are associated with tne DETANK coamana. 


ae CLEAR command. 
be. RECALL command. 
Ce NY command. 
de. RY command. 
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DI Command 


i a DI ee St tation<lsn> pT Tee 
| <2 > 7 : <Station Name> —<text>— 


The DI command may only te issued by a controttler» an attached program 
or the controlling function. The MCS reports the delayed resuit to the 
requestor. | 


The optional <?> represents a nondisplayable character (a00a thru glFa). 
When specified 2 a a user program» responses are given in internal 
format. 


Following are examples of how the DI command may be used. Refer to 
the syntax diagram. 


OY TO839XA 


RELATED COMMANDS. 
The following commands are associated with the DI command. 


ae EI] command. 
be MX cOmmand. 
ce. NY command. 
d» OL command. 
e. RY command. 
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DIALIN COMMAND 


The DIALIN command aliows the user to configure a switched tine to 
conform to the specified remote site in the site phone directory. The 
syntax of the DIALIN command is provided telow. — 


nn en as 
| <site-name> | 


The DIALIN command allows the user to prepare to receive a diatin alert. 
from a nonstandard site (a site that cannot enter its own <site name> 

as the first input over the tine). This command is not restricted, 
however» to nonstandard sites. | 


This command may only be issued by a task» a control station or the 
CC file. 


The <phone~number> or <site*name> must correspond to a vatid site in 
the site phone directory. 


If the switched Line is not busy it 1s configured and left not readye 
The requestor must’ issue an RY L <ttn> command in order to ready the 
line for dialin. 


When a diatin alert is received it is reported to the lLine’s controtling 
function Cor to the monitor stations if there is no controlling 
function) in accordance with the format specified when the CF comanand 
was issued. Refer to the CF command in this section. This alert 
indicates that a manual dial has occurred (at either end of the tined. 


If a disconnect result is received» it is reported to the Line's 
controlling function (Cor to the monitor stations if there is no 
controlling function). In additions if the line was cOnnected to a 
standard sites the tine is reconfigured so that all stations associated 
with a standard site on that line in the directory are attached ta that 
line. This is called the TOTAL/SITE configuration and atlows suk- 
sequent messages to the MCS to be received from any station in any 
standard site on that Line. | 


If the site was nonstandard the line 1s not reconfigured. The 
controlling function Cor other controtter) should issue another RY L 
<itn> command to ailow for a dialin or a DISC L <tln> command to 
atlow the Line to te reconfigured to TOTAL/SITE. Refer to the CONF 
command in this section for an explanation of standard/nonstandard 
sites. 
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DIALIN COMMAND 


cont 


Fotlowing are examples of how the OIJALIN command may be used. Refer to 
the syntax diagram. 


Exaasples: 
 DIALIN SITE 1 
DC DIALIN RJESITEI 


RELATED COMMANDS. | | 
The following commands are associated with the DIALIN coamand. 


ae CF command. 

be CONF command. 

ce DIALOUT command. 
de DISC command. 

ee. RY command. 
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DIALOUT Command | 


DIALOQUT COMMAND. 


The DIALOUT command allows a user to dial aremote site. The syntax of 
the DIALOUT command is provided tetow. | 


“Lat 
—<?>— 


<phone-no. *1> 


a 
<site-name> 


Line —<lln>—~—-<phone-no. *2> 


The DIALOUT command may onty be issued by a task» a controd station or: 
the CC file. The MCS reports the delayed result to the requestor. 


The optional <?> represents a nondisplayable character 2002 thru aiFa. 
If it is specified» reSponses are given in internal format. 


The site phone directory is built at system initialization after con- 
figuration of the network is completed. It may te updated at any time 
using the CONF command. Refer to the CONF command in this section. 


The site phone directory is organized alphabetically by site name. For 
each site name listed» the following information is provided. 


ae Nonstandard indication Coptional). 

b. <Phone number> for diating out Coptional). 
Ce <iln>. . 

d. Station configuration of the remote site. 


If a valid <site name> or <phone number> is specified» the MCS checks 
to determine if the remote Line is connected. If it is connected>s an 
error message 1s returned. 7 


If the remote line is not connected» the MCS does the following. 


ae Reconfigure the remote line based on the information contained 
in the site phone directory. 


be Queues a message (TYPE = DIALQUT) on the NDL queue with the 
phone numter in the text field. 


ce Returns an immediate valid result to the requestor (CQ). 


de Waits for an answers when one is received reports it to the 
requestor (TQ). 


1 Phone number of site in directory. 


2 Line not in directory. 
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DIALOUT Command 


cont 


If Line <lin> <phone-number> 15 specified» the requestor must te a 
controlter. If the requestor is not a controtler an error message 

is returned. If the requestor is a controller the MCS verifies that 
the Line is in the site phone directory. If it is in the directory. 
tut the site is not configured» an error message is returned. If the 
site is configured the MCS uses the specified <tin> and <phone number> 
to queue a DIALOUT<“type message on the NDL queue. An imaediate valid 
response is returned. When the MCS receives the message result from 
the DIALOUT» it is reported to the controlling function Cor to aonitor 
Stations if there is no controlling tunction). 


Following are examples of how the DIALOUT command may be used. Refer: 
to the syntax diagram. a 


DIALOUT L 9 1234689 
DC DIAL SITE! 
DC DIAL 2691105 


RELATED COMMANDS. : 
The fotlowing commands are associated with the DIALOUT command. 


ae CF command. 

b. - CONF command. 
ce DIALIN command. 
de OISC command. 
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JISC COMMAND 


ppzs dTsc (Disconnect Specified Line or Site) command allows the user to f 
wdisconnect the specified tine or site. The syntax of the DISC command | 
lis provided below. | 


<?> 7 


<phone-no.> 


site-name > 


Line <lin> 


eThe DISC command may only te issued cy a task» a control station» or: 
the CC file. The MCS reports the delayed result to the requestor. g 


If a switched line is referenced ty one or more sites in the site phone 
directory» it ts automatically configured to the TOTAL/SITE configura | 
ation (refer to the DIALIN command in this section for a definition of 
TOTAL/SITE). Therefore» regardiess of which standard site dials in» 
the <site name> can be entered as the first message from that site. 
This allows the MCS to reconfigure the switched line from the phone 
directory to een that site. 


If a remote site that dialed in then disconnects itself (Data Set Not 

Ready)» the MCS automatically reverts to the TOTAL/SITE configuration. 
If any of the stations on that tine are attached to user datacom pro” 

grams» they are automatically detached. 


If the line is configured to TOTAL/SITE» and a directory dial is 
performed» the MCS configures the switched Line to match the specified 
site in the phone directory and initiates the catl. In this case, if 
the remote site disconnects» the MCS does not reconfigur2 to TOTAL/SITE 
but does report the condition to the line*s controlling function Cor | 
monitor stations if there is no controlling function). fhe controlling 
function should then issue another DIALOUT» or DISC command. 


When a DISC command is issued one of the following occurs. 


ae If the line 1s connected and the requestor is a controller» 
a message of type DISCONNECT Cimmediate tine not ready) is 
queued on the NDL queue and an immediate valid response is 
returned to the requestor. Sutsequently» when a Line not 
ready result 1s received with type DISCONNECT» the controlling 
function ts notified.» The tine 15 then reconfigured to 
TOTAL/SITE af in the directory» or left not ready if so 
instructed (NY L <iln>) during the initial network 
configuration. 
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DISC COMMAND 


cont 


b. If the tine 1s connected due to other than a DIALOUT comanand> 
the Line is disconnected and an immediate valid result is 
returned to the requestor. Sutsequently» when the result is 
received ty the MCS it is reported to the requestor and to the 
Line*s controlling function Cor to the sonitor stations if 
there is no controlling function). 


ce If the Line is not connected» and if a site is configured», a 


disconnect from the remote site (data set not ready) has 
occurred on a tine that was configured for aremote sitee If. 
the line is in the dtrectory it 1s reconfigured to TOTAL/SITE 


and an immediate valid response is returned to the requestor . 
No further action is taken. 


Following are examples of how the DISC command may te used. Refer to . 
the syntax diagran. i 


DISCONNECT LINE 3 
DC DISC FRED 
DC DISCONNECT 2691109 


RELATED COMMANDS. | ) 
The following commands are associated with the DISC command. 


ae DC command. 

be CONF command. 

ce DIALIN command. 
de OIALOUT command. 
ew NY command. — 
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DT COMMAND 


DT_COMMAND. 
The CT (Oetach queue/station) command atlows the user to detach a reat 
station or a dummy station (CC» OC or MX<integer>) from an implied user 


datacom program. The syntax of the DY command is provided below. 


DT (DETACH STATION FROM QUEUE) COMMAND: 


is CS ¥ 
<queue-name > / 


<text > 7 
> <text > 


[ station-family > E 


If the DT command is entered from a noncontrol reat station» onty OT 
may be specified. | | 


If the request is entered from the SPO» CC file» or a control station 
and a station list or text 1s specified» or from a user datacom program» 
<queue~name> must be specified. 7 


If <queue~na@e>/ is the last element of the command (1.@22 CC» DC» MXn- 
=» or a <station-fanily> list does not follow it) the implied station 
1s assumed to be the statton of the sender Ci.ee.» from Control Command 
file then CC» from SPO then DOC» from program then MXno from a real 
station then station-name). 


If any station other than the default (Cdurmy) statton is to be detached 
it must be specified. 


If the detach request ()T command) is entered from a programs the 
<queue"name> may refer to any transaction queue assigned to that program. 
An expression of the form <queue~name>/MX <integqer> may be specified 

by a program where <queue"name> 1s the primary transaction queue 

assigned to the requesting program. If <queuesname> is the primary 
transaction queue the following two functions occur. 


ae The specified dummy station» MX<integer> is detached from the 
requesting program's transaction queue. | 


pb. The requesting program dummy station is detached from the 


primary transaction queue of the program associated with the 
specified dummy station. | 
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DT COMMAND . 


cont 


The detach request causes the MCS to detach the specified/iaplied 

Sstation€s) from the indicated user program. Each subsequent attempt to 

send a message to a detached station results tn an error Cieees a 

STATUSKEY of 20» destinatton unknown» or access denied to the user by 

GEMCOS). Also» no additional input messaces from a detached station 
are placed or the program's transaction queue. 


Attached programs are notified of a Sige through a message on the 
program's transaction queue in the following form for a GENCOS 
application program. 


—GEMCOS header with 


“MCS.STATION.CLOSED byte set to @31@7~sbatton-name= 


for a TMCS interface the message appears as follows: 
<station-name> *DT 


When a datacom program goes to end-of*jobs ali attached programs 
receive the Detach-End-Of-Job (DTECJ) message. If the initiating 
program sends one or more messages to the initiated programs» but the - 
initiated progragr goes to end-ofsjob without receiving from its 
transaction queues» the initiating program's Output Count (€0C) is 
decremented accordinsty. 


Following are exanples of how the OT command may be usede Refer to the 
Syntax diagram. 


- Examples: 

OT 

DT FILE1/ 

DY FILE4/MX7 USER TEXT 


RELATED COMMANDS. 
The Seedy commands are associated with the DT command. 


ae ASSIGN and EX commands. 
be AT command. 

Ce RN command. 

de PL command. 

@e CLOSE command. | 


DUMP COMMAND 


DUMP COMMAND. 
The DUMP command atious the user to examine the vaiues in the tnternal 
MCS tables. The syntax of the DUMP command is provided belou. 


DUMP COMMAND: , - 
en i Manel i ia) 
<text > | | | | 


The DUMP command is a restricted Network Control Command» and therefore | 
may only be issued by a control stations a control programs a 
controiting functions or the CC file. 


The DUMP comaand is used to produce a Listing of the MCS internal 
tables. This tisting may be used for debugging. The following tables 
are listed. 


ae STATION table. 

b. STATION INDEX table. 

Ce DUMMYSTATION INDEX table. : 
ee. LINE table. 

te DCP table. 

ge TRANCODE table. 

he TRANCODE LINKAGE table. 
te TASK table. 

je MIX INDEX table. 

ke. QUEUE table. 

me TASK INPUT COUNT table. 
ne GLOBAL table. 


Output from the DUMP command is directed to the Line printer. If 

the MCS ts tracing on the printer at the timer the output appears on 
the same tisting.e. If the Line printer is not available the output ts 
printed on the SPQ. 


Response to the DUMP command consists of one message groups containing 
one or more messages. If there is only one message» it has END KEY=3. 
If there is more than one message present» onty the Last message has 
END KEY=3» the others have ENO KEY=2. Refer to the CMS COBOL Reference 
Manual» form 2007266 and the CMS Message Processing Language (MPL-ITI) 
Reference Manual» form 2007563. 
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DUMP COMMAND. 


cont 


Following are examples of how the DUMP command may be used. Refer to 
the syntax diagram. 


DUMP MCS TAS8LES 
DUMP 


RELATED COMMANDS. 
The following commands are associated with the DUMP command. 


ae LT command. 
be SO command. 
ce. RC command. 
de TRACE command. 
ee GT command. 
f. NT command. 
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FI COMMAND 


‘The EI CEnabte- Input) command atlows a user to togically enable input. 


“Yi from a specified station. The syntax of the EI command is provided 


LI GC. -.} LJ] ~ 
<?>- <Station. Name> LL. eet 


The EI command may only be issued by a controller,» an attached programs 
or the controlling function. The MCS reports the delayed result to the 
requestor. 


The optional <?> represents a nondisplayable character (a0G3 thru a1F2). 
When specified by a user programs» responses are given in internal 
format. | 


Following are examples of how the EI command may be used. Refer to 
the syntax diagram. | 


SED ak skh wa 


EI TD839XC 
EI STATION 28° 


RELATED COMMANDS. | 
The following commands are associated with the EI comanand. 


ae DY command. 
be MX command. 
Ce NY command. 
d. OL command. 
ee RY command. 
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P< a ae US GRD 8m ca 4 eR ae ae 


The ENG CEnquiry Limit/Count) command altows the user to determine the 
contents of a specified timit/count. The syntax of the ENQ command 
1s provided cetow. 


ENO (ENQUIRE LIMIT/COUNT) COMMAND: 


IL <Isn > , 
po IC <isn saudi a / - <station-name > — | 


OL <mix TT... 
OC <mix>— = / - <<program-name > 


/ - Squeue-name > 


SC <\sn > / = <station-name > 


ENQUIRE 


A count of messages 1n the MCS queue may te obtained by entering 
ENQUIRE MC. 


Following are the four types of timits/counts associated with message 
flow. | 


Limits Counts 
Input Limit CIL) Inout Count CIC) 
Jutput Limit COL) Dutput Count (OC) 
Subnet Queue Limit (QL) Subnet Queue Count (QC) 


Station Cueue Limit CSL) Station Queue Count (SC) 


INPUT LIMIT CIL) AND INPUT COUNT CIC). 

The network controlter maintains an Input Limit CIL) a an Input 

Count (CIC) for each station. A station's Input Count 18s incremented by 
one each time the station places a vatid input message on the CS 
queues it 1s decremented ty one whenever the MCS issues a continue 
station communicate. Jf a station inputs a message but its Input Count 
1S Greater than or equal to its Input Limit» message space 18 not 
altocated and the messaqe 1s refused. The Input Limit is tnititiatly set 
to 2 ty the NDiL compiler tut may te changed by the MCS using the 

SET command. kKefer to the SET command in this section. 
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ENQ COMMAND 


cont 


~QUTPUT LIMIT COL) AND OUTPUT COUNT COC). 

The network controller maintains an Output Limit (OL) and an Output. 
Count (OC) for each user datacom programe. <A user's datacom program's 
Output Count ts incremented by one each time the program places a SEND 
message on the MCS queue. The program's Qutput Count is decremented by 
one whenever the MCS issues a continue program communicate. If a 
program sends a message but its Output Count is greater than or equal 
to its Output Limit» message space is not ailocated and the program is 
suspended. The Output Limit for each program is initially set to two 
by the NOL compiler but may be changed by the MCS using the SET command. 
Refer to the SET command in this section. 


SUBNET QUEUE LIMIT (QL) AND SUBNET QUEUE COUNT CCC). 

The network controlter matntains a subnet Queue Limit (QL) and a subnet 
Queue Count (QC) for each subnet queue in the system. Each time a valid 
gnput message is placed directly on the subnet queue by a station 

(not through the MCS)» the subnet queue*s Queue Count is incremented 

by one. The Queue Count is also incremented by one whenever the MCS 
queues a message for that subnet queue. Whenever a message is removed 
from the subnet queue» its Queue Count is decremented by one. If a 
station inputs a message but the subnet queue’s Queue Count is greater 
than or equal to its Queue Limit» message space is not allocated and 
the input ts refused. The Queue Limit is initially set to 2 by the NDL 
compiter but may be changed by the MCS using the SET command. Refer to 
SET command in this section. 


STATION LIMIT (CSL) AND STATION. COUNT (SC). 

The network controtter Matntains a Station Limit (SL) and.a Station 
Count (SC) for each station queue in the system. Each time an output 
message is sent to a station by a program (not through the MCS)- the 
station®s Station Count is tncremented by one. The Station Count is 
also incremented by one whenever the MCS queues a message for the 
statione Whenever a message is removed from the station queues its 
Station Count is decremented by one.e. If a program sends an output 
message to a station whose Station Count 1s greater than or equal to 
its Station Limit» message space is not allocated and the program is 
suspended. fhe Station Limit is tnitiaity set to 2 but may te 
changed by the MCS using the SET command. Refer to the SET command 
in this section. 


ENG COMMAND 


cont 


Following are examples of how the ENG comrmand may be usede Refer to 
the syntax diagram. 


Examples: 
IL 2 
IC 14/TCYA 
OL 2/CCTEST 
ENQ QL O/ BISA 
Qc 1 


ENQUIRE SL L4/STATIONA 


RELATED COMMAND. | 
The SET command is associated with the ENQ command. 


GT_COMMAND. 


The Gf CGet Trace) command allows the user to trace messages associated 
with. a particular programs queue» or station to a. line orinter or to 
the Event tog disk file. -The syntax of the GT command is provided 
below. , . 


GT (GET DC TRACE) COMMAND: 


—— GT ——— <mix > oo aE 
—< mix > /<program-name > TEXT — 2 ah | - DISK - i 4 
ee Sats | oat Ee innagar 
— << queue-name > / , | peel 
STATION <Isn > 7 


<station-name > TEXT 


MONITOR — 


The GT command is a restricted Network Control Commands» and therefore 
may only be tssued by a control program» a control Station» or a 
controlling function. 


By default the NOL message headers are traced. If TEXT ts specifieds the 
message text and the NDL message headers are recorded. 


If MCNITOR is specified for a station» the MCS queues a message to the 
network controller. This message is 35=bytes in Length has TOGGLES = 


1 (byte 26)» TALLY (0) = 0 Cbhyte 24)» and STATION = the logical station 
number Clsn) of the station being monitored. 


NOTE | 
MONITOR is used with a specific Network 
Definition Language Capability. Ci.ec» 
NOL must be able to recognize and ‘ 
process the above message from the MCS). 


If I is specified» only input messages are traced. Input messages are 
of the following types. 


ae 1° Input. 
be 4 = Enable input. 
ce 5 * Disable input. 


If 0 is specified> only output messages are traced. Output messages 
are of the foliouning types. 


ae 2 = Qutput. 
be 3 - Priority output. 
Ce 24 = Send. 


GT COMMAND 


cont 


If neither { or 0 is specified» both input and output messages are 
traced. Also traced are messages of type 6 (make station ready) and 
type 7 (make station not ready). 


If DISK ts specified» messages are logged in the Event tog rather than 
traced to the line printer. Each message traced into the event tog con- 
tains the message header and text.» If the Event log is not on disks a 
new log is opened for tracing purposes. This log has a default size of 
512 records which may be altered using TCL specifications. 


If <integer> is specifieds the file size is <integer> times the speci=- 
fied value Cor the default value of 512). The <integer> must be a 
value between i and 127» or an error message is given. 


NOTE 
The MCS participates with any station 
involved in a trace. When the trace ts 
terminated» the MCS no tonger partici=- 
pates with the station unless it was 
participating with it before the trace 
began. Onty a running datacom program 
may be traced. 


When a progran being traced goes to endwof-job the trace is creeped 
cleared from that <mIx>. Refer to the NT command in this section. ! 


Fotlowing are suaenves of how the GT. command may be used» Refer to the 
syntax diagraa. 


Exaaples: 
GT 2/DCTEST TEXT 
Gr aot 
GT FILE4/ 
GT STATION 8 
GT TD@30XA T M 6 


RELATED COMMANDS. 
The following coamands are associated with the GT command. 


ae NT command. 
b. TRACE coamand. 


HALT COMMAND 


The HALT counand allows the user to initiate an orderly shutdown of 
the MCS. The syntax of the HALT conumand is provided below. 


HALT pelea 


- FAST 
RECOVERY 


COLD 


The HALT command allows a controtler to initiate a gradual termination 
of the datacom subsystem» the MCS» and any running datacom programs. 
Files are closed in an orderly manner. Once termination begins» no 
user datacom programs are altowed to start. 


If only HALT is specified» the MCS performs the fotlowing functions. 
ae Queues a message (*1) on the primary transaction queue of each 
running datacom program» notifying the programs that the MCS 
is terminating. 3 
be Waits until allt user datacom programs go to end=of"jot. 


c. Makes all stations not ready» recalling and tanking any 
outstanding messages. 


d. Clears the MCS queue» copying each message cleared fro the 
MCS queue to the line printer Cif it is available). 


ee. Notifies the SPO that the MCS 15 terminating. 
f. Closes files and stops. 
If HALT FAST is specified» the MCS does the following. 


ae Ctears the 4CS queue» copying each message cteared from the 
MCS queue to the Line printer Cif it is avaitable). 


be. Notifies the SPO that the MCS is terminating. 


ce. Closes files and stops. 


For a CEMCOS: tite ace rogram the message consists of a 
. yte.GEMGOS. header. with MCS-HALT~FLAG set te 1. For 
a TMCS interface program the message consists of . 


<12-bytes blanks>*TERMINATE,. Revised 5-14-81 by 
~~ 7 - s -, | | : PCN 1106796-001 8-35 


HALT COMMAND 


cont 


if HALT RECOVERY is specified» recovery wil! occur at the next MCS 
initialization. The shutdown of the system then continues as 1f only 
HALT had been specified. © , 

If HALT COLD is specifieds a cotd start will occur at the next MES 
initialization. The shutdown Of the SyStem then continues as if only 
HALT had been specified. | 


Following are examptes of how the HALT command may be used. Refer to 
the syntax diagram. | 


HALT FAST 


RELATED COMMANDS. a 
The following commands are associated with the HALT command. 


ae TERMINATE command. 


ct. STOP command. ~ - 
ce RESTORE command. | 
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LC COMMAND 


The LC (Log Comment) command allows the user to enter a comment into 
a specified loge The syntax of the LC command is provided betow. 


LC (LOG COMMENT) COMMAND: 


aoe fe EVENT <comment > 
CONTROL | 
The <comment> may consist of any disptlayatle character. If the 
<comment> exceeds 170 character» it is truncated. 


Log comments may onty be entered into logs which have been enabled. 
Logs may be enabled and disabled using the SO (Set Options) and the 
RO (Reset Cptions) commands. Refer to the SO and RO commands in this 
section. 


Following are examples of how the LC command may be used. Refer to 
the syntax diagrag. | 


Exaaples: 
LC ER 3200 PM» TUES» JAN 28» 1980 SYSTEM REQUESTED NEW ACCESSKEYS 
LC CO 2200 PM» WED» JULY 3» 1980 WEATHER CLEAR» 90 HEAVY SMOG CONDITIONS 


RELATED COMMANDS. 
The following cosgmands are assoc iated to the Lc command. 


a» LL command. 
be. RO command. 
ce $0 command. 
d.- LC command. 


| LL COMMAND | 


”1LL COMMAND. 


Me wiThe LL (List Logs) command allows the user to list» on the Line printer> 


YT the contents of any or all of the following MCS logs. 


ae The Event loge 
b. The Control tog. 
ce The Error toge 


The syntax of the LL command is provided telow. 


LL (LIST LOGS) COMMAND: 


— LL 


L <integer > 


EVENT 
ERROR - 
CONTROL 


The LL command is a restricted Network Cortrot Commands and therefore 


may only be issued by a control program» a control stations or the 
CC file. 


“The LL cneaand 1s used to produce a listing of the contents of the 


specified tog(s). The tisting contains both headers and text. Each 
fieid is described and the text portion of the message is peaneed 
directly below the appropriate needing 


If no log is snecitieds all logs are listed (separately). Records are 


Listed in chronological order. 


The Event tog is closed (by default) and must te opened before being 
specified. Refer to the SO or the GT commands in this section. The 
Error log and the Control log are open (by default). 


For the Event tog if option <n> ts specified» the most recent <n> 


entries are listed. 


For the Error and/or Controt togs if the option <n> is specified» all 
entries of the specified type included in the most recent <n> entries 
of the file» are listed. | | 


If <nm> exceeds the number of entries existing in a log» the entire 
contents of the log are tisted. If <n> exceeds the file size» an error 
message is displayed. | | 


The togs are printed at the line printer» or» if a printer is not 
availables at the SPO. The first record of the Control or the Error 
Log is a header record containing information used by the MCS. 


The Event tog contains all messages processed by the MCS and all teyose: 
comments. | 


LL COMMAND 


cont 


The Error tog contains alt error messages» fetch value errorss and 
logged comments. | 


The Control tog contains ail Network Control Commands and messages 
derived from the following. 


ae SET CInput» Output and Queue Limits) communicates. 

b. Queue initiating message communicates. 

ce DISALLOW communicates associated with the DT command. 
de Logged Comments (tC) messages. 


The Controt tog also contains attach/detach messages as well as the 
resulting atlow/disallow communicates. , 


| NOTE 
The default size of the Evert Log and 
the Controi/Error log is 512 records. 
The user may specify the size of new 
logs (after removing the existing ones) 
in TCL. When a file is full» new entries 
write over the previous entries» starting 
at the first old entry. 


Alt Logs may be disabled via the RO commands and enabled via the SO 
command. | 7 | 


Following is the format of the CONTROL/ERFOR Log Header Record. 


Byte | | Neaning 
0 a002 = the log has not wrapped around. 
aFFa@ = the log has wrapped around. 
1-2 | Contains the number of the first tlogical. 
record. 
374% Contains a count of the number of ERROR 


type entries when the MCS was initialized. 


LL COMMAND 


cone 


10-11 


12-13 


Meaning 


Contains a count of the number of CONTROL 
type entries. | 


Contains the record number of the tast 
TERM command. 


Indicates how the NCS was last terainated 


ae aFFe = abrupt termination (DSed» 
etc.) or new log. 


be 2002 = graceful termination via 
the TERM or HALT commands. 


Size of the log. 


The number of the tast togical record. 


= 


Fotlowing are Log Entry Formats. 


Byte 
0 


en 3 


Meaning 
Log Type (LTYPE): 


ae QO = EVent. 
be 1 = ERror. 
ce 2= CQOntrotl. 


Message Type (MTYPE): 


ae 0 = Comment. 
be 1 = Message. 
Cs 2 = Communicate. 


Sequence Numrter: incremented by 1 for 
each LTYPE. 


Date of Entry? YVYMMDD. 


LL COMMAND 


cont 


Byte Meaning 
779 | Time of Entry: HRMNSC. 
10 - EQR Message information as follows: 


a) MTYPE G - Comment. 


t) MTYPE 1 = Message Header (35 
bytes) + TEXT. 


c) MTYPE 2 = Communicate. 


The formats of the four MTYPE-1 messages are as follows. 
ae ATTACH.INPUT.STATION 


1) HDR.TYPE 76 


2) HDR.TASK = <mix> 

3) HDR. SUBNETQ = <tqn> 

4) HDR.~STATION = <tsn> 

5) %TEXT.BYTES 1°12 = <progr aa-name> 

6) TEXT.BYTES 13°24 = <queue-name> 

7) YTEXT-BYTES 25-36 = separioneneues 

Note 
If necessary» <program-name>», <queue- 
name>» and <station"name> may be padded 
out with spaces. 
The formats of the seven MITYPE-2 MCS tog messages are as follows. 
ae ALLOW. INPUT 
1) <INFO.BYTES 17°12 = "ALLOW. INPUT" 
2) INFO.BYTE 13 = <lqn> 


3) INFO.BYTE 14 = <mix> 


LL COMMAND 
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cant 


b. 


ALLOW. OUTPUT 

1) [NFO.BYTES 1°13 = ALLOW. OUTPUT" 

2) INFO.BYTES 14°15 = <tsn> | 

3) INFO.BYTE 16 = <mix> 

DISALLOW. INPUT 

1) INFC.6YTES 17-15 = "DISALLOW. INPUT® 
2) INFO-BYTE 16 = <tqn> 

3) INFO.~BYTE 17 = <mix> 

DISALLOW. OUTPUT 

1) INFO.BYTES i-16 = "“DISALLOW.CUTPUT™ 


2) INFO.BYTES 17°18 = <tsn> 


.3) INFO.BYTE 19 = <mix> 


Ce 


SET eINPUT.LIMIT 
1) INFQ.eBYTES 1-162 “"SETSENPUTLIMIT" 


2) INFO.B8YTES 17: <tsm 


3) j%XINFO.BYTES 18:2 <limit> 


Ge 


~—~SETCOUTPUT.LIMIT 


1) INFO.BYTES 1-17: “SET. OUTPUT «LIMIT™ 
2) INFO.BYTES 18: <mix> 

3) IONFO.BYTES 19: <limit> 
SETeQUEUE.LIMIT 
1) INFO.SYTES 1-16: “SET.QUEUE.LIMIT™ 
2) INFO.~BYTES 17718: <queue-reference> 


3) INFO.BYTES 193 <limit> 


LL COMMAND. 


cont 


Following are examples of how the LL command may be used. 
syntax diagram. 


Exagoles: 


LL 6 


iL EV 25 


LL ER 


RELATED COMNANDS. 
The fottowing commands are associated with the LL 


ade 
be 
Ce 
de 
Ce 
tf. 


LC command. 

LG cogmand. 

RCO command. 

$0 commands. | 
TERMINATE command. 
HALT coamand. 


Refer to the 


command .o 


LC COMMAND 


LO_COMMAND. | - 
The LO (List Options) command attows the user to determine which 
runtime options are set. The syntax of the L090 command is provided 
below. ; 


LO (LIST OPTIONS) COMMAND: . 


mes  . * .  ° & 
| <text > ——" s | | _— 


When the LOG command is executed» the system checks the status of all 
runtime options and disptays any options that have been set. 


Options may be set and reset ty the SO and RO commands respectively. 
Refer to the $0 command in this section for a description of the 
runtime options available. Atso refer to the RO command in this 
sectione | 


Following are examples of how the LO command may be used. Refer to 
the syntax diagram. 


LO USER TEXT 


RELATED COMMANDS. | 
The foltowing commands are associated with the LO command. 


ae RO command. 
6. SG command. 


LOGOFF COMMAND 


The LOGOFF command allows the user to sign off a Logged-on Station. 
Fhe syntax of the LOGOFF command is provided below. 


LOGOFF COMMAND: 


—— LOGOFF ————________-___ 


The LOGOFF command may only be entered from a real station. fhe 
station is cleared of practice mode operations and any togged-on user 
is togged~off. 


If aprogram is attached to the station» and the LOGONALERTS attribute 
specified in TCL is set to TRUE» the program is notified of the log-off 
through a message placed on the program’s primary transaction queue. 


For a GEMCOS interface programs the lLog-off message consists of the 
SO0*byte GEMCOS HEACEF with the MCS-LOGOFF flag set. 


For a TMCS interface programs the LOGOFF message consists of <i2-byte 
station name>*LOGOFF. 


Foltowing is an example of how the LOGOFF command may be used. fFefer 
to the syntax diagram. 


RELATED COMMANDS. | 
The following commands are associated with the LOGOFF command. 


ae LOGON command. 
fb.» CHANGE command. 
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| LOGON COMMAND | 


LOGON COMMAND. 
The LOGON command attows the user to sign-on to an accesscontrotled 
station. The syntax of the LOGON command is provided bel owe 


LOGON COMMAND: 


~—-LOGON <access-key > , ee 
| < password > _ 


If the LOGON command 1s entered from a logged-on stations GEMCOS 
automatically togs-off the current user. 


The LOGON command is only for use with real stations. 


If a program is attached to the access~controtled stations» and the 
LOGONALERTS attribute specified in TCL ts set to TRUE» the program is 
notified of a successful logon through a message placed on the 
program's primary transaction queue. 


For a GEMCOS interface program» this message consists of the 50-byte 
GEMCOS header with the MCS-LOGON flag sets» followed by the 12-character 
station name and the’ 16-character access~key. The message appears as 
follows for a GEMCOS interface program. | 


< 0-byte header with 
| <ucs. LOGON set to 1 > <station-name> <access-key> 


For a IMCS interface program» the message consists of a <*i2“byte 


station name>*LOGON followed by the L6-character accesskey. It 
appears in the following fora. 


<station-name>*LOGON<access-key> 


If a station goes down (1-€e» not ready)» it is automatically ltogged-off 
but it remains attached. 


If the <access“key> is defined in TCL with an associated <password> 
both the <access“key> and the <password> must be present to lLog-on. 


Accesskeys and/or passwords may be entered in quotation marks in order 
to tinctude spectat characters. 
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LOGON COMMAND 


cant 


Following are examples of how the LOGON command may te used. Refer to 
the syntax diagram. 


jes 


Examples 
LOGON FIRSTNAME LASTNAME 
LOGON CAT 
LOGON ACCESSKEY 


RELATED COMMANDS. 
The following commands are associated with the LOGON command. 


ae LOGCFF command. 
be CHANGE command. 
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} LT COMMAND | 


LI_COMMAND. | 

The LT CList Tables) command allows the user to examine the vatues in 
the internat “CS tables. The syntax of the LT command is provided 
below. 


LT (LIST TABLES) COMMAND: 
a in ee 
< text > 


The LY command is a restricted Network Control Command, and therefore 
may only be issued by a control program» a control stations or the 
CC file. | 


The LT command is used to produce a listing of MCS tnternal tables. 
This listing may be used for debugging. The following tables may be 
Listed. 


ae STATION table. 

be STATION INDEX table. 

Ce DUMMYSTATION INDEX table. 
de. ODUMMYSTATION table. 

ee LINE table. 

fe DCP table. 

ge TRANCODE table. 

he TRANCODE LINKAGE table. 
1. TASK table. 

je MIX INDEX table. 

ke. QUEUE table. 

tL. ATTACHMENT table. 

me TASK INPUT COUNT table. 
ne GLOBAL table. 


Gutput from the LT command is directed to the line printer. If 

the MCS is tracing on the printers the output appears on the same 
listing. I&If the line printer is not available» the output is printed 
on the SPQ. 


Response to the LT command consists of one message groups containing 
one or more aessagese If there is only one message» it has END KEY=3. 
If there is more than one message presents only the last message has 
END KEY=3- the others have END KEY=2. Refer to the CMS COBOL Reference 
Manual» form 2007266 and the CMS Message Processing Language (MPL-IT) 
Reference Marual» form 2007563. 


LT COMMAND 


cont 


Following sere examples of how the LT command may be used. Refer to. 
the syntax dtagram. 


Examples 
LT MCS TABLES 
LT 


RELATED COMMANDS. | | 
The following comgmands are associated to the LT command. 


ae DUMP command. 
b. SC command. 
Ce RC command. 

de TRACE command. 
ee GT command. 

f. NT command. 
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MCSLOGOFF COMMAND 


> aur <P aa ase ace ae <P am O8> 2D nn sab ae ae ae 


The MCSLOGOFF GMCS Log Off) command is onty for use by the remote 


SPO Interface Programs (SPIM). This command allows the SPIM Program to 
log-off from both the MCS and the MCP as the System Control Language 
CSCL) handler. The syntax of the MCSLOGOFF command is provided beloun. 


MCSLOGOFF COMMAND: 


——~ MCSLOGOFF 


GEMCOS verifies that the command is from SPIM and that SPIM is 


logged-on as the SCL handler. If the request is valtids GEMCOS performs 


an MCS.LOG.OFF communicate. 


Following is an exampte of how the MCSLOGCFF command may be used. 
the syntax diagram. 


Exasple: 
MCSLOGOFF 


RELATED COMMANDS. 
The fottowing corsmands are associated with the MCSLOGOFF command. 


ae MCSLOGON command. 
be MCSRUN’ command. 7 
Co READMESSAGESQUEUE command. 


Refer to 


MCSLOGON COMMAND 


The MCSLOGON CMCS Log On) command is only for use by the remote SPO 
Interface Program» (SPIM). This command allows SPIM to log=on to both 
the MCS anc the MCP as the System Control Language (SCL) handler. The 
syntax of the MCSLOGON command 1s provided betow. 


MCSLOGON COMMAND: 


_— = MCSLOGON 


< password > 


GEMCOS verifies that no SCL handler is currently togged-on. GEMCOS 
then performs an MCS.LOG.0ON. communicate» passing as a parameter the 
optional password. 


NOTE 
It is expected that onty SPIM 1s lLogged=- 
on as the SCL handler» but this its not 
enforced. Any program could tlogzron as 
the SCL handler. For convenience within 
this manual» the name SPIM ts used in 
all references to the SCL handter. 


Following is an example of how the MCSLOGON command may be used. Refer 
to the syntax diagram. 


Exaaple: 
MCSLOGON FRED 


RELATED COMMANDS. 
The fotlowing commands are associated with the MCSLOGON comand 


ae MCSLOGOFF command. 
be MCSRUN command. 
ce READMESSAGESQUEUE command. 


MCSRUN COMMAND 


MCSRUN COMMAND. | | 
The MCSRUN (C¥CS Run) command is only for use by the remote SPO Inter- 
face Program» (SPIM).}j This command passes System Control Language (SCL) 


input to the “CS. The syntax of the MCSRUN command 1s provided below. 


‘MCSRUN COMMAND: | | +o, 32 
—— MCSRUN TT <6-byte header ><text > 2 Ae cena 
:<6-byte header ><text > | | 


GEMCOS verifies that the request its from SPIM and that SPI“ is togged=- 
one If SPIM is not Logged-one an error is returned on the prograa'ts 
communicate queue. If the request is from SPIM» GEMCOS scans the text 
portion of the messaye Looking for the foltowing SCL command. 


If SQ is being runs GEMCOS does the following. 


ae ZIP with pause the SCL (SQ) command. 
be Return an immediate valid result on SPIM's communicate queue. 


If PG is being run» GEMCOS does the following. 
ae Clean the Error tog as if preparing to terminate. 
be. Run the SCL (CPO) command with the MCS.RUN communicate. 


NOTE 
If the PO is of the system disk and only 
SPIM and GEMCOS are in the wrixs the MCP 
DS's SPIM and GEMCOSs c and d are 
not executed. If GEMCOS is not DS‘ed» 
the implication is that the system disk 
was not POted and GEMCOS cont inues 
executione 


ce Restore the Error tog to its original status since the #CS 1s 
stitl executing. It was not DSted and the system has not 
teen PO*ed.. 


de Return either an Aeeodtxbe valid result or an appropriate error 
on SPIM®s communicate queue. . 


MCSRUN COMMAND 


cont 


If neither SQ or PO is being runs GEMCOS cerforms an MCS.RUN commun=- 
icate using the SPIM supplied text. An immediate valid result or an 
appropriate MCP fetch value error ts returned on SPIM*s communicate 

queue. ; 


The <6-byte header><text> must be contiguous and cannot exceed 255 
bytes in length. 


Following are exampies of how the MCSRUN command may be used. Refer to 


onion 


the syntax diagram. 
Examples: 

MCSRUN XXXXXXOL LPA 
MCSRUN XXXXXXLIST ABC 


RELATED COMMANDS. 7 | 
The foltowtng commands are associated with the MCSRUN command. 


ae MCSLOGON command. 


b. MCSLOGOFF command. | 
Ce REACMESSAGESQUEUE command. 


@=553 


MERGE COMMAND 


MERGE COMMAND. — 
The MERGE command is used to merge the compiled formats in an external 
files with those in the live format file (MCSFMT). The syntax of the 


MERGE command is provided below. 


MERGE COMMAND: 


TT MERGE — <file-name > 
| RMERGE 


9 


< format > 


The MERGE command 1s a restricted Network Control Commands and. 
therefore may only be issued from a control stations a controt progr am » 
a controtling functions or the CC file. 


Once the files are merged» the formats contained in the external file 
are accessible to users and programs. 


If MERGE is executed» new formats do not replace previous formats of 

the same names. If RMERGE is executed» the new formats replace previous 
formats of the same names. If no format list ts specified» the entire 
format file is merged. 


New resident formats do not become residert until the MCS is 
resexecutec. These formets are considered to te nonresident until the 
re-execute is coaplete. . 


Response to the MERGE command consists of one message groups containing 
one or more sessages.e. If there is only one messager it has END KEY=3. 
If there is more than one message present» only the tast message has 
ENO KEY=3» the others have END KEY=2. Refer to the CMS COBOL Reference 
Manual» fora 2007266 and the CMS Message Processing Language (MPL-IT) 
Reference Manuals form 2007563. 


Following are examples of how the MERGE command may be used. Refer to 
the syntax diagram. ; 


MERGE NEWFORMATS 
RMERGE DISKA/FORMATATFILE FORMATL» FORMAT2 


There are no related commands. 


MX COMMAND 


MX_ COMMAND. = 4 | 
The MX (Diagnose DC Mix) command informs the requestor of the status of 
the requestec user datacon progran(s). The syntax of the MX command its 


provided below. 


MX 


MX (DIAGNOSE DC MIX) COMMAND: 


| <?> 


/ - <program-name > 


The MX command allows the user to interrogate the datacom mix. If the 
optional <mix> is included» the status of the specified program 1s dis- 
played. If the optional <mix> is not included» the status of all 
datacom programs are displayed. 


The <?> (Coptionalt) represents a character that cannot be disptayed 
(2002 thru aifa). If it is specified» responses are given in internal 
format. 


Response to the MX command consists of one message group» containing 
one or more wessagese If there is only one messager it has END KEY=3. . 
If there is more than one message presents» only the last message has 
END KEY=3» the others have END KEY=2. Refer to the CMS COBOL Reference 
Manual» form 2007266 and the CMS Message Processing Language (MPL=II). 
Reference Manuals form 2007563. 


MX COMMAND 


cont 


Folitowing are examples of how the MX command may be used. 


syntax diagrane 


MX 2/DCTEST 


RELATED COMMANDS. 
The following commands are assoctated 


ae 
De 


with the MX command. 


Refer to the 


NT COMMAND 


The NT No Trace) command is used to stop a message trace, Refer to the 
GT command in this section. The syntax of the NT command is provided 


NT (NO DC TRACE) COMMAND: 


—— NT <mix > 
<mix >/<program-name > <text > 
QUEUE <lan > 
<queue-name > / 
STATION <Isn > 


<station-name > 


The NT command is a restricted Network Control Command> and therefore 
may only be issued by a control station» a control program» or the 
cc file. 


Lad 


The NT command shuts off any current trace on the specified mix» queues. 
or station. OQptions set in the GT command for the specified item are 
stopped by the NT command. | 


Following are examples of how the NT command may be used. Refer to the 
syntax diagram. | 


NT O3/0CTEST 


RELATED COMMANDS. 
The foltowing commands are associated with the NT command, 


ae GT command. 
Ce TRACE conm and. 
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NY COMMAND 


fst commana. 


mJ} The NY CNot Ready) command is used to make a line or a station not 
‘jpready» The syntax of the NY command is provided tetow. 


Fo stl © Even 5s Peace | | | 


ee ais -name > 


The NY command is a restricted Network Control Commands» and therefore 
may only be issued by a control stations a control programs the 
controlting function of the Line or station» or the CC file. 


If a station is made not ready» incoming messages are sent to an 
alternate station. If no alternate stations are found» aessages are 
tanked on disk. | eG | 


Practice mode and logon are cancelled when a station is made not 
ready. a 


Following are examples of how the NY command may be used. Refer to-the 
syntax diaglame 


NY LINE 9Q 
NY S$ 14 
NY TO83OXKA. 


RELATED COMMANDS. 
The following commands are associated with the NY command. 


a» For network status? Ol» RY» 4X and STATUS commands. 


— PE RS BERETS BACCO Ta jn ONE asthe bee PEL ONE AS 


be For recovery: CL» RE» &Y» and RD commands. 
a ce. For network change: RL» RS» KD» and CONF commands. 


8958. 
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OL COMMAND 


The OL COn Line) poneand may be used to do the following. 


ae 
datacom processor (DCP)>» 

b. Request the status of a line» 
processor. 


Refer to the CONF command 
this file. 


Request a description and/or court of a tine» 
terminal or modem. 


stations queues 


a stations a queue» or a datacon 


Request information about the cortents of the MCSITENIF file. 
in this section for a description of 


Following is a discussion of these capabilities and the syntax diagram | 


which applies to each. 


OL DESCRIPTICN OR COUNT. 


This command may be used to 
specified network elements. 


OL (DESCRIPTION OR COUNT) COMMAND: 


LINE 
STATION — 
~ QUEUE | 
DCP —— 
TERMINAL 


STATION <Isn > 
<station-family > 
QUEUE <Iqn> 
<queue-name > / 
DCP <iIpn> 

TERMINAL <itn > 
MODEM <imn> 


The optional <?> represents a nondisptayatle character » 
and may only be specifted by a user program. 


responses are given in internal format. 


Response to the OL command consists of one 
one or more messages. 
If there is more than one message present» 
END KEY=3» the others have END KEY=2. 


i. oe COUNT 


If there is only one message» 


request a description and/or a count of 
The syntax of the OL command for a 


description and/or count is provided below. 


DESCRIPTION — 


DESCRIPTION — 


C3002 thru alfa) 


If it is specified» 


message group» containing 
it has END KE Y=3. 
only the tast message has 


Refer to the CMS COBOL Reference 
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OL COMMAND 


cont 


Manuals form 20907266 and the CMS Message Processing Language (MPL<IT) 
Reference Manual» form 2007563. 


If no element (Lines statione queue» OCP» terminal or modem) is 
specified» a description or count of alt elements tn the network is 
displayed. 7 : 

If LINE» STATION» QUEUE» DCPe TERMINAL» or MODEM ts specified» but no 
<iin>» <tisn>» <ign>» <ipn>s <itn>» or <tmn> is specified» a description 
or count is displayed for all elements of the specified type» along 
with a count of that element. If an element is snocet lode a descrip- 
tion is displayed for the specified element. 


Following are examples of how the OL (description or count) command fay 
be usede Refer to the syntax diagram. 


OL LC 
OL SC. 
OL S$ 14 D 


OL TOS30XA D 


OL FILEI/ D 
OL DCP D 


OL DCP OC OD 
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OL COMMAND 


cont 


RELATED COMMANDS. | 
The following commands are associated with the OL (description or 
count) command. 3 


ae OL Cstatus) command. 
be. OL CSITENIF) conmand. 
Ce MX command. 

de RY commande 

e. NY command. 

f. ENQ command. 


OL STATUS. — 
This command may be ised’ to request the status of specified network 
elements. The syntax of the OL cogmand for the status of network — 
elements 1s provided below. 


OL (STATUS) COMMAND: 


“otehe 
| Se LINE - 


LINE <iIn > 
STATION 
STATION <Isn >- 
<station-family > 
QUEUE 

QUEUE <iqn> 
<queue-name > / 
DCP 

DCP <Ipn> 


The optional <?> represents a nondisptayatle character» (2002 thru 
aifa)d). If it is specified oY a user programs responses are given in 
Internat format. 


Response to the OGL command conststs of one message groups containing 
one or more gwessagese. If there is only one message» it has END KEY=3. 
If there is more than one message presents onty the last message has 
END KEY=3» the others have END KEY=2. Refer to the CMS COBOL Reference 
Manual» form 2007266 and the CMS Eoesage Processing Language (MPL<-IT) 
Reference Manual» fora 2007563. 


OL COMMAND 


cont 


{If no Liner Stationr Queue» or DCP 1s specified» the status of alt 
Lines» stations» queues» and DCPs is disptayed» atong with a count of 
each element. | 


If a Lines a Stations a Queue» or a DCP 18s specified but no <tln>» 
<tsn>» <lqn>» or <lpn> is specified» the status of att lines» stations» 
queues or DCPs is displayed (depending on which type was specified)» 
altong with a count of that element. 

If a LINE <iln>» a STATION <isn>» a queue <lqn>» a DCP <lpn>» or a 
<station-néame> or <queue-name> is specified» the status of the speci- 
fied Lines stations queue» or DCP is displayed. 


Following are examples of how the OL (status) command may be used. 
Refer to the syntax diagraa. 


Exaaples: 
OL 
OL Lt 
OL .t O 
OL S 14 
OL TOE30XA 
OL Q | 
OL Q 3 
OL FILE1/ 
OL OCP 
OL OCP OQ 


RELATED COMMANDS. 
The following commands are associated with the OL (status) command. 


ae OL Cdescription or count) command. 
be. OL CSITENIF) command. 

Ce MX commande | 

de RY command. 

@e NY command. . 

f. ENQ command. 

ge RD command. 

he RL command. 

1- RS commande 


OL COMMAND 


cont 


OL SITENIF. | | | | | 
This command may be used to dieotay information about the contents of 


the MCS Site Network Fite (MCSITENIF) file. The syntax of the OL 
command (SITENIF) is provided below. 


OL (SITENIF). COMMAND: 


a 
<n a ” 


STATION 
LINE <iIn> 
STATION <Isn > 
<station-family > 


92) 


ITENIF 


The optionat <?> represents a nondisptayatle character» (39002 thru 
aifa). If it is specified responses are given in tnternat format. 


Response to the OL command consists of one message groups containing 
one or more messages. If there is only one message» it has END KEY=3. 
If there is gore than one message presente only the tast message has 
END KEY=3» the others have END KEY=2. Refer to the CMS COBOL Reference 
Manual» form 2607266 and. the CMS Message ocemenn Language (MPL-IT ) 
Reference Manuals form 2007563. 


If no Line or Station is specified» the MCSITENIF information is 
displayed for ait lines and Stations» along with a count of each 
element. 


If Line or Station is specified but no <ltn> or <tsn> is specified» the 
MCSITENIF information is displayed» atong with a count of that element. 


If Line <ttn>» Station <isn>» or a <station-name> or <queue-name> is 
specified» MCSITENIF information is displayed for the specified Line or 
Station. | 


OL COMMAND 


cont 


Following are examples of how the OL CSITENTF) command may he used. 


Refer to the syntax diagram. 


OL TD830XA SI 
OL S SI 
OL Li SI 


RELATES COMMANCS. 
The following commands are associated with the OL 


ae OL Cdescription or count) command. 
b. OL (status) command. 
ce STATUS command. 


(SITENIF) command. 


PL COMMAND 


PL_CUMMAND. 

The PL (Program Load) command is onty for use with data entry programs. 
and-terminals. Jt operates in the same manner as the KN command. Refer 
to the RN command in this section. The syntax of the PL comnand is 


provided below. 


PL nnn << DTOSTAM nl | eee ae 
sida / <program=name > —4. <optional fields> | 


<queue-name> / 


NEW / 
<integer> / = 


<integer> NEW / 


= 10 = {/— _ NOACK . <text> 


LOGONALERTS -: <text> 


9 


—- <station-family> 


If the PL command is executed» the NDL pRetocel Saancons. from Datacom 

CDC) mode to Data Entry (DE) mode and queues a sign-on message of «PL 
instead of *RN for TMCS tased applications. Therefore the PL command 
is valid only tor DE terminals (389347)s»° which the MCS pocoaacs as 

Stations with names beginning with 893. 


Following are syanuves of how the PL command may be used» Refer to 
the syntax diagram. 


PL BOBSCHU TO = USER TEXT 
PL PROG FILE1/ NOACK 


RELATED COMMANDS. 
The following commands are associated with the PL comaand. 


ae RN command. 
be EX and ASSTGN command. 
Cs AT command, 
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Pk COMMAND 


PP_COMMANDs 


The PR CAsstgn Priority) command attows the user program to assign a 
CMS priority to a specified (or default) datacom programe The syntax 


of the PR command is provided telow. 


— PR 


STATION — <{sn > -/-<station-name > 


<mix > / <prograiri-name > 


QO wo rp OD WwW PY 


If a <mix>/<progqram=name> is specified» D is not a valid priority class. 


If station <isn>/<station-name> is specified» the priority class of the 
indicated station is assigned as specified. When a datacom program is 
initiated from a station» the priority class of the indicated station 
is assigned to the program. The default priority class o9f a station is 
De. The D is not a valid CMS priority ctass» but it causes GEMCOS to 
allow the program to run at its CMS assigned default. 


Tf no reference is made to either a station or a program» the PR 
command must be entered at a Station. The MCS reassigns the 
priority class of the station. r 


The PR command is a restricted Network Controt Command» and therefore 
May onty be i8s5Ued by a control program,» a control station» or the 
CC file. 


. NOTE 
PytThe PR command cannot te used on the 
yi8 65 or the 8 99 system. 


PR COMMAND 


cont 


Fottowing are examples of how the PR command may es used. Refer to the 
syntax diagram. 


PR STATION 24/TD8300XKA OD 
PR S3/CFRSCANDE C 
PR 2/DOMUNTVERSAL C 


RELATEC COMMANDS. 
The following commands are associated with the PR command. 


as MX commande 
be OL command. 
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PRACTICE COMMAND 


PRACTICE COMMAND. - 
The PRACTICE command aliows the user to set a real station ins or take 
it out» of. practice wmode» The syntax af the PRACTICE command 15 


provided belou. 


PRACTICE COMMAND: 


— — ON 
OFF 


3 


<station-family > 


The PRACTICE command is used to set active», nenassigned stations ins 
or to take then out of practice mode. If a station is in practice 
mode» applications will te notified with each message from the station 
of its practice state. If a station name is omitted» this command 
defaults to the requesting station. | | : 


The PRACTICE command may not be applied to a concentrator» hoster or a 
nonparticipating program. | 


Onty controllers may set or reset practice mode on stations cther than 
themselves. Practice mode is cleared if a statton 1s logged-e-off » 
or made not ready. | | 


Programs are notified of practice mode through the MCS message header 
for every fessage sent from a station. If the MCS-PRACTICE-MODE 

flag is set to 1» the station sending the message is in practice mode. 
If the MCS*PRACTICE“MODE flag is set to O» the station is sending a 
live message. 


When processing a lists» if an error is encountered» processing of the 
command 1S stopped. Previous assignments remain valid. 


Following are examples of how the PRACTICE command may be used. Refer 
to the syntax diagram. 


Exaagples: 
PRACTICE ON 
PRACTICE ON TD830XA 


PRACTICE OFF TD83XB» TD830XD 
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PRACTICE COMMAND 
cont 


RELATED COMMANDS. _ | 
The following commands are associated with the PRACTICE command. 


ae 
be 
Ce 
d. 
Ge 
f. 


ASSIGN and EX commands. 
CLOSE cemmand. 

DI command. 

RN commande 

PL command. 

AT commande 


RD COMMAND 


RD_COMMAND. 
The RD CReload? command is used to retoad a Datacom Processor (DCP). 
The syntax of the RD command is provided telow. 


RD (RELOAD DCP) COMMAND: 


RD - 


- <Ipn > 


<program-name > - 


The RD command allows the user to reload the specified DCP with a 
“Specified Network Definition Language Program. If optional paraseters 
are not entered» the standard datacom NDL Program (NDLDCP) is reloaded 
into DCP 9. 


This command may only be issued by control programs» control stations» 
the controtling function of the specified DCP» or the CC file. 


NOTE 
This command is not applicatle to the 
B 80 or the B 90 systen. 
Fottowing are examples of how the RD command may be used. Refer to the 
Syntax diagram. 
Exaaples: 
RO 
RO O 
RD NIPSIPS 
RD GO NIMC 


RELATED COMMANDS. 
The fotlowing commands are associated with the RD command. 


ae CONF conmand. 


be RL command. 
Ce RS command. 


5-70 


| READMESSAGESQUEUE COMMAND | 
READMESSAGESQUEUE COMMAND. 


The READMESSAGESQUEUE command ts only for use ty the remote SPO 
Interface Program» (SPIM). This ccemmand causes GEMCGS to read any 
System Control Language (SCL) output from the MCP and pass it to SPI*#. 
The syntax of the READMESSAGESQUEUE command is provided below. 


REAUWESTAGESQUEUE COMMAND: 
—-~ READMESSAGESQUEUE 


GEMCOS verifies that the request 1s from SPIM and that SPIM is 
iogged-on. If not» an error message is returned. 


If the request is valids GEMCOS performs a READ. MESSAGES QUEUE 
communicate and basses the results park to SPIM. 


Following is an example of how the READMESSAGESQUEUE command may be. 
usede Refer to the syntax diagram. 


mS 
gen 
fos 


EXae 
READMESSAGESQUEUE 


RELATED COMMANDS. 
The following cogmands are associated with the READMESSAGESQUEUE 
poanants 


ae MCSLOGON coamand. 
be MCSLOGOFF command. 
' ge MCSRUN command. 


RECALL COMMAND 


RECALL COMMAND. 


a Ree 


The RECALL command recalts unprocessed messages from a specified queue. 
The syntax.of the RECALL command is provided below. 


RECALL (RECALL UNPROCESSED MESSAGES FROM SPECIFIED QUEUE) COMMAND: | 


po RECALL ~ 
Laeitieiine 


-STATION <\sn >———— 
— <station-name > 


- QUEVE <ign> 


- <queue-name > / 


TO STATION <Isn >- 


—| 
© 
Uv 
'@) 


- <station-name > 


QUEUE <Iqn> 


| 


< queue-name > |: 
LP 


The <?> Coptional) represents a nondisptayable character (20¢C2 thru 
aif2). If it 1s specifieds responses are given in internal format. 


This command atlows the user to recall unprocessed messages from a 
specified station» subnet queue» or an iaplied stations to a specific 
Cor implicit) destination. If the recatl request is input from a 
Station and no source is supplied» messages are recalted from that 
station. 


The destination specified may be a stations subnet queues or the tine | 
printer. If a destination station queue is specified» the recalled 
messages may be top=queued on that station queue. If no destination 
is specified» the recailed messages are returned to the requesting 
program@"’s primary transaction queue» the station» or the SPO. 


Two messages are generated for each recalled message where the SPQ 

or the Line printer is the destination. The first is a leader message 
identifying the location from which the second message was recalted. 
The second message is the recalled message. If arecalt is issued from 
a statione that station must be attached to a line. 


If the message is destined for a subnet or station queue and has never 
been recaileds a 4&-byte leader message and the message text are 
forwarded as a single new message. 


RECALL COMMAND 


cont 


Messages that have been recaited before are forwarded to the user after 
the old Leader is overwritten ty the new one. 


If the RECALL command is entered at a noncontrot statione only that. 
station®s messages may be recalled. 


If the RECAL“L command ts entered from a aoncontrol programs only 
messages from stations and queues attached to the noncontrol programs 
and messages from any station with the noncentrol program as the 
controlling functions may be recalted. 


Foliowing ere examples of how the RECALL command may be used. Refer to 
the syntax dtagram. | | 


Examples: 
RE 5 0 
RE TD830XA TO FILEI/ 
RECALL QUEUE 12 TO S 24 TOP 
RE FILE/ 


RELATED COMMANDS. | 
Ihe following coamands are associated with the RECALL command. 


ae CL command. 
be RY command. 
ce NY command. 
de. RD commande 


RESTORE COMMAND 


RESTORE COMMAND. | 

The RESTORE command is used to clear MCS internal table entries 
atlocated to programs by the MCS. The syrtax of the RESTORE command is 
provided bhetow. | pas 


RESTORE (RESTORE MIX AND/OR QUEUES) COMMAND: 


— alii Wk ALL 
| -<mix > 


The RESTORE command is a restricted Network Control Commands and 
therefore may ontiy be issued by a control station» a control program, 
a controlling functtones or the CC file. 


If a datacom program is being restored» orty secondary transaction 
queues» which are reserved but never used by a program» are cleared. 


If a nondatacom program is being restored» all queues and stations 
aliocated to that mix are cleared. 


Following are examples of how the RESTGRE command may be used. Refer 
to the syntax diagram. 
Examples: 

RESTURE 3 

RESTORE ALL 


RELATED COMMANDS. : 
The foitlewing commands are associated with the RESTORE command. 
ae DUMP cogmand. 
b. LT command. 


RL COMMAND | 


The RL CRecefine Line) command ailows the user to redefine the <type> 
and/or <moces> fields of a specified line. The entire field must be 
specified. Fields that are not specified are not changed. The syntax 
of the RL cormand is provided below. | 


RL_COMMAND. 


RL (REDEFINE LINE) COMMAND: 


—————— RL <Iin > 


TYPE = : ae MODEM = <Imn > 
<integer > | 


The RL command is a restricted Network Control Command» and therefore 
may only be issued by a control program» a control stations or a 
controlling function. 


If RY @s not spectfieds the tine ts Left in the NOT READY state. A 
line sust be not ready before the RL command is executed. 


Following are examples of how the RL command may be used. Refer to the 
syntax diagram. , 


Examples: 
RL 9 
RL G T=292008 
RL 0 T=129 (bit 1 and bit 9) 
RL O M=1 


RL 0 M=1 RY 


FL COMMAND 


cont 


The following table defines the items in the syntax diagram. 


lten | Meaning 


<iin> Lcgical Line Number of Line to be 
Pedefined. 


TYPE 4 hexadecimal digits of Line TYPE 
or an integer as fotilows: 


STANDBY TRUE 

STANDBY OPTION 

LOW GR HIGH RATE 

RATE SELECT CAPABILITY 
LOSS OF CARRIER ACTION 
LINE PULSE/ATY 

DIALOUT CAPABILITY 
DIALIN CAPABILITY 
ASCII/EBCOIC SYNC 
ASYNCHRONOUS 


MODES The fogical mode number asso- 
ciated with this line. 


RY ' Leave the line in a READY 
State fottowing the Pedefine 
Line. 


RELATED COMMANDS. 


BIT 
BIT 
BIT 
BIT 
BIT 
Bil 
BIT 
BIT 
BIT 
BIT 


The fotlowing coamands are associated with the RL command. 


ae CONF coamand. 
be RD command. © 
Ce RS command. 


FQ COMMAND 


oes pip Se Re ES MS de 


The RD (Reset Uption) command allous the user to reset the runtime 
options The syntax of the KO command is provided betow. 


aipmemmmrememanennses ’ 


Pe -| 5 (pees CM ETE | 


DEBUG sities CALC Scan 


ALLOW 
8 : 
| ECHO _| 
The RO command is a restricted Network Control Commands and therefore 
may only be issued by a control station» a control programs or the 


CC file. 


The RO command resets the runtime options. The options are set by the 
30 command and are disptayed by the LO command. Refer to the $O and LO 
commands in this section. 


ALL avaitable options are defined under the SO (Set Option) comanand. 
Refer to the SO command in this section. 


Following are examples of how the RO command may be used. Refer to the 
Syntax diagram. 


RG CHECK DEBUG» ERLUG ALLOW 
RO EVLOG 

RO 7» 5, 6 

RU DEBUG, 5 EVLOG ALLOK 


RELATED COMMANDS. 
The following commands are assoctated with the 8&9 command. 


ae SQ commande 
be LO command. 


Revised 5-14-81 by 
PCN 1106796-001 . b=77 


RN COMMAND 


‘RN COMMAND. 


The RN CFun)-command allows a terminal, a programs a CC files, or a SPQ 
‘to initiate a unique copy of a specified user datacom program and 
attach to it. The syntax of the FN command 1s provided retow. 


| Ansiienet natant totuaihiaie 
<disk-id> / <program-name>—+ <optional fields> 


~ <queue-name>/ — 
NEW/ 
<integer> / 
<integer> NEW / | | | 
ae 
oe" | ie | NOACK <text> 
- , LOGONALERTS — : <text> 


9 


acer ton~ family > 

The RN command works in the same nanner as the ASSIGN or EX Command 
with three exceptions. Refer to the ASSIGN and EX commands in this 
section. These three exceptions are as fotlows- 


ae A.-new. copy of the soquastad: program 1s always initiated. 


be Stations that are not included in the initiating message 
cannot tecome attached to this orogram with one exception: 
program <program=name> gay attach stations to jtsetf (egardless 
of how it was initiated) Fy issuing an ASSIGN» AT or £X 
Network Control Command. 


ce A sian"on message of *FN instead of *EX is queued on the 
user's transaction queue for TMCS interface. 


Following is an example of how the FN command may be used. fFefer to 
the syntax diagram. 7 


EP enh cae we ae ee 


RN CMSPACK/C MSC ANDE U BOB DI SCRATCH 


RELATED COMMANDS. 
The following commands are associated with the RN command .— 


ae ASSIGN and EX commands. 
b. CLOSE command. 

ce OF command. 

de PL command. 


RS COMMAND 


RS _ COMMAND. | 
The RS CRecefine Station) command allows the user to redefine a hen 
specified station's redefinable fields (the fields may be specified in| * 
any order). The syntax of the 8S command is provided below. 


RS (REDEFINE STATION) COMMAND: 


| 296 <isn > / <station-name > 


LLN = <integer > MUI= 1 


MUO = 0 — MUI = 0 


SSB = 1 ENI = 1 END = <string > — DEL = <string> 
SSB = 0 : ENI=0 | : 


BSP = <string > WRU = <string > CON = <string > 


FRQ = <integer > ADR = <string>, <string > TYPE = iz @ <type >@ 
| ADR = <string> —————— L_ <integer > 


TERM =<itn > 


SPEED = T @ <speed > @ 
<integer > 


RETRY =<integer > | RY 


Onty those ftelds for which optiona!t information is specified are 
modified. Setting LLN=255 moves the station off the tine but does 
not update any other fields. | | 


If a station is not on a line and is not teing moved onto a Line» no 
changes are made. GEMCOS responds with an error message. 
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RS COMMAND 


cont 


Lf two addresses are specified» ADR=<string>» <string>» the lteft-. 
most <string> is the receive address and the rightmost <string> is 
the transmit address. 


If RY is specifieds the Line associated with this station is Left in 
ready. | 
NOTE 
The line associated with this station 
must be not ready before the RS command 
is issued. 


Following are examples of how the RS command may be used. Refer to the 
syntax diagram. 


RS L4/STATIGNA LLN=255 

RS 1IS/STATIGNB CON=@2 Aa 

RS AS/STATIOND CON="*™ 

RS 24/TOB3SOXA LLN=2 SPEED=20800a 


RELATED COMMANDS. 
The following commands are associated with the RS command. 


ae CONF command. 


b. RL command. 
ce RD command. 


BED 


RS COMMAND 


cont 


The following table defines the items tn the syntax diagram. 


Itea * 3. —s Meaning 


<isn> | Logical Station Number of station to be 
: redefined. 


€<station=name> NOL defined. Station Name of station to be 
redefined. 


The characteristics of a station that may te altered are: 


Lin Logical Line Number to which station is te be 
assigned or 255 (No line). 


MUO My Use Output. 

MUI | My Use Tnpute 

$58 Second Stop Bit. 

ENT Enable Input. 

END END Character. 

DEL DELETE Character. 

BSP | BACKSPACE Character. 

WRU Who aRe yoU Character. 

CON CONTROL Character. 

FRQ Station FREQUENCY. 

ADR Station ADDRESS. 

€string><string> Receive Addresss» Transmit Addresse 

<string> Receive = Transmit Address. 

<type> Four hex digits of Station TYPE. 
(See figure 8-1)» as follous: 
aD MODE SIT 13 
TELE X BIT 12 
MGDEM BIT 7 
ASCII/EBCDIC SYNC BIT 2 
ASYN/S YNC Bry 1 


RS 


COMMAND 
cont 


<speea> 


<teon> 


—6<€ttn> 
RETry 


RY 


eh a a 


Four hex digits of Station SPEED (see Figure 
B-2). | 


Logical Mode Nuwber. 
Logical Terminal Numter. 
Station RETRY Count. 


Make the Line READY following the Redefine 
station. 


RUN COMMAND 


RUN COMMAND. 


ayatar command allows og USO 022 1p Command sot Mer ee ceur ote 


RUN COMMAND: 


 —— RUN—<text > 


The RUN command is a restricted Network Controt Commands and ther efo 
may onty © Tssued by a control program» a control stations or the 


anaes 


“Cc file. 


The RUN command permits remote execution of applications programs and 
MCP tntrinsics. | 


The maximum text length is go> “ehavac tors. 


following are examples of how the RUN command may be used. Fefer 
to the syntax diagram. 


Examples: | 
RUN TASK1 
RUN COPY FILE1 TO FILE2 
RUN DS O2/LIST 


RELATED COMMAND. 
The ZIP command is assoctated with the RUN command. 
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FY COMMAND 


bp The KY CReady) command allows a user to make a line or station ready. 
ri the syntax of the FY command is provided betow. 


Ty. ) iicduacat © 
<?> STATION <isn > | 


| 
<station-name > aaceiets 


The KY command is a restricted Network Control Commands and therefore 
may only te issued ty a controt station» a control programs the 
controlling function of the Line or station to be readied» the | 
CC files or a program attached to a station being made ready. The MCS 
i | reports the delayed result to the requestor. 


Following are examptes of how the FRY command may Fe used. Refer to the 
Syntax diagram. 7 


be 
oul 
oh 


14 
FY TD&3ZOXA 


RELATED COMMANDS. 
The following commands are associated with the RY Command. 


ae QOL command. 

b NY commande 
C% MX command, 
de STATUS command. 
Qe. CL command. 
f. PE command. 
Ge NY command. 
he FD command. 

m RL command. 

e RS command. 

- PD commande © 
e CONF command. 


BEG 


SEND COMMAND. 


SEND. COMMARD. 

The SEND command attiows the user to send messages. to real stationss 
programs» and the SPQ. The syntax of the SEND command is provided 
below. , | 


SEND COMMAND: 


a~ 


— SEND <string>. TO- <station-famity >- 


SPO 


<program-name > 


ALL 


The SEND command is a restricted Network Control Commands and 
therefore may only be issued from a controt station» a control orogramp 
a controlling functions or the CC file. | 


If SEND TO ALL is specified» the SPO and all real stations in the 
network receive #essagese Stations acting as hosts may not be 
addressed by the SEND command. 


GEMCOS interface programs are notified on their primary transaction 
queue of broadcast messages through the MC5 message header. The MCS= 
BRCADCAST°“FLAG is set to 1 in the MCS message header» and the nage of 
the sender is ptaced in tytes 50-61» followed ty the message. 

™MCS interface programs may not receive SEND messages. 


Following are examples of how the SEND command may be used. Refer to 
the syntax diagram. 


SEND "WHAT'S UP» DOC?" TO TORSOXA 
SEND "SYSTEM GOING DOWN" TO ALL 
SEND *HELLO™ TO PROGRAM ECHO 


RELATED COMMAND. | | 
The 10 command is assiciated with the SEND command. 
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SET COMMAND 


SET_ COMMAND. 
The SET (Set Limit) command atiows the specified Input Limit CIL) 

Output Limit COLI» Queue Limit (QL)» or Station Limit (SL) to be set 
to an integer from 1 to 127 tnclusive. The syntax of the SE¥ coamand 


1s provided below. 
SET (SET LIMIT) COMMAND: 
IL <Isn>> / <station-name > <integer > 
OL <mix > / <program-name > ii 
QL <Iqn> / <queue-name > 
SL <Isn > / <station-name> 


—— SET 


The functions of each of the types of Limits that may te set are 
described under the ENQ command. fkefer to the ENQ command in this 
section. | 


This statement may be executed by a controlter. ft may atso be 
executed by any program to change its output timit» or the queve Limit 
of any of its queues» or the station Limit or input limit of any 
Station attached to that program. 


When a program which ts not a control program goes to end-of-jobs any 
Six» Qt» IL» or OL that the program changed is restored to its default 
value» which is the Last value to which the timit was set to by a 
controtter. ' 


Following are examples of how the SET command may be used. Refer to 
the syntax dtagraa. | 


SET lL 24/TD@20XA 5 
SET QL 12/FILE1 10 


RELATHO COMMAND. | 
The ENQ command is associated with the SET command. 


SO CUMMAND 


oe SO : | 


DEBUG - < text> 


ALLOW 


ECHO 
The SO command is a restricted Network Controt Commands» and phenerers 
may only be issued by a control station» a control programs or the 
CC file. 


The option names and their corresponding option numbers are 
interchangeable The user may choose the order of the runtime options 
specified» however» the options Listed in the syntax must te separated 
by a blank(s) or one comma. If there 1s more than on2 comma separ ating 
the options» or if an option is misspetted»s the remainder of the syntax 
1s considered to be text and is ignored. If the first oation specified 
is misspelled» an error message is returned. 


If the DEBUG option 1s specified» NDL message headers of alt messages 
output to the MCS are printed on the Line printer. If tne tine printer 
In not availabler» the DEBUG option 15 not set and thus does not appear 
in the valid response tist of options. 


If the TMCS option is specified» all administrative MCS nessages placed 
on atransaction queue of a program not defined in TCLs, wilt Fre in the 
shifted TMCS interface format. Fefer to section 5 for a complete 
explanation of shift and TMCS interface. : 
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90 COMMAND 


cont 


If the CHECK option is specified» a trace 1s enabdled. Fefer to the 
TRACE command in section @®. The trace is printed on the Line prtnter:. 
If the Line printer is not availables the CHECK option is not set and 
thus does not appear in the vatid response List of options. 


If the EVLOG» EPLOG» or COLOG options are specified» the respective MCS 
logs (Event log» Error tog» or Control tog) are enabled. fFefer to the 

LL command in section 8 for a description of these logs. If the Event 

log 1s not enabled (because the MCS was unatle to successfully open the 
Fvent log)» the EVLOG option is not set and thus does not appear in 

the valid response List of options. 


The ALLOW option when requested» wilt DISPLAY/ACCEPT In response to 
Valid ATTACHe-QUEUE/ATTACH.~STATION requests. 


If the ECHO option is specified» alt unrecognized transattions are 
repeated. No error message is returned. 


Following are saeoles of how the SO command. May be aeedu: Refer 
to the syntax diagram. 


SO CHECK ALLOW 
SO 1 ALLOW ERLOG 
SQ &» DEBUG 6» 5 


RELATED COMMANDS. | 
The fotlowing commands are related to the $0 command. 


ae RO command. 
Ce LO commande 


STATUS COMMAND 


The STATUS enw and allows a user to obtain GEMCOS net work status and 
message traffic reports. The syntax of the STATUS command is provided 


— STATUS 


<lin > 
INE 


<station-family > 


— SPO 

PROGRAM <program-name > 

MIX — | 
, Sisseahoncl4 -snhaaniten > 

ALL - LINES 


STATIONS 
PROGRAMS 
QUEUES 


If a tines station» program» or queue identifier is speci fied» the 
STATUS command reports on the status of each. If an identifier is not 
provided» the STATUS command reports on the status of the requestor, | 


If STATUS ALL LINES» STATIONS» PROGRAMS» or QUEUES is requested» alt. 
Lines» stationsse datacom programs» or queues in the network are 
profiled» If STATUS MIX is requested» all running programs are 
profiled whether they are datacom programs or note 


Fesponse to the STATUS command consists of one message gr oupe 
containing one or more messages. If there is onty one Nessage» it has 
END KEY=3-. If there is more than one message presents only tne last 
message has END KEY=3»5 the others have END KEY=2. Fefer to the CMS 
COSOL Reference Manuals form 20707265 and the CMS Message Processing 
Language Manuals» form 2°07563. | 
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STATUS COMMAND 


cont 


When an error ts encountered within a list» processing of the command 
is stopped. The status of alt preceding entries is reported. 


Following are examples of how the. STATUS command may be used. Refer to 
the syntax diagram. | 


xamples: 
STATUS LINE 1 
STATUS 


STATUS ALL QUEUES 


RELATED COMMANDS. 
The following commands are associated with the STATUS command. 


ae DUMP and LT commands. 
be OL command. 
ce MX command. 


3S TOP COMM AND 


STOP _ COMMAND. 

The STOP command attows a user to send an end=of-job request to a_ 
prosgram without halting the network. The syntax of the STOP comaand 
is provided below. 7 


STOP COMMAND: 


<program-name > 


ALL PROGRAMS 


The STOP command is arestricted Network Controt Commands and 
therefore may onty be tssued by a controt stations a control program» 
or the CC file. 


When the STOP command is requested for a GEMCOS interface program» a 
SO°-tyte HCS header is sent to the program's primary transaction queue 
with the MCS“HALT°FLAG set to 1. 


For a TMCS interface programe the STOP command sends a me ssafje 
consisting of <12-bytes of blanks> followed by a *TERMINATE to the 
program*’s primary transaction queue. 

If an error is encountered in a list» processing of the command is 
stopped» but all preceding entries in this list receive the ST6P 


messagee The STOPs HALT» and TERMINATE commands are indi stinguishable 
to an application programe 


Following are exaaptes of how the STOP command may be used. Refer to 
the syntax dtagraam. : 


Exasples: 
STOP TASKL»> 3 
- $TOP ALL PROGRAMS 
STOP 3/PROG9 


RELATED COMMANDS. 
Following are commands associated with the STOP command. 


ae HALT command. 
be. TERMINATE command. 
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| STOPTEST Comsand 


STOPTEST_ COMMAND. | | 

The STOPTEST command allows the user to selectively terminate testing 
initiated. by the TEST command. The syntax of the STOPTEST command is 
provided below. 


STOPTEST COMMAND: 


STOPTEST 


ALL — -* <text> 
_ ’ , 
. P-Stations f <isn> 
4 - 
<Station-Family> 
/ 
Unless the STOPTEST command is issued by a noncontrot station that is 
only terminating testing for itsetf» this command is a restricted 
Network Control Command» and therefore may only be issued by a controt 
program» a control station or the controlling function... 
If an invalid station name is entered in the station list» the | 
remainder of the tine is considered to be text. If the first station 
name is invalid an error message is returned. , 
If the command is issued from a noncontrol stations it implies onrty 
that stations and the options ALL» /» or stations other than the issuing. 
station» may not be specified. 
If ALL or / is specified» testing of all stations is terainated. If 
ALL or / is not specified» the specified (Cor default) station(€s) not 
attached to a user prograag are terminated. 


Foltowing are examples of how the STOPTEST command may be used. Refer 
to the syntax diagram. 


- Examples: 
STOPTEST S 29 
STOPTEST / 
STOPTEST ALL 


STOPTEST TD830XC» TO&30XA 
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STOPTEST Comsand — 


cont 


RELATED COMMANDS. | 
The fotlowing cosmands are associated with the STOPTEST command. 


ae LT 
be TEST 
ce T0 
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TERMINATE COMMANE 


Ob ap wD a a ae ee at <> em ae abe oes a 


The TERMINATE lake silat the user. to initiate a shutdown of 
the “CS. The syntax of the TERM command is provided below. 


TERMINATE COMMAND: 


— TERMINATE 7 on Eas 
| FAST — | —_ 


The TERMINATE command attows a controtter to initiate termination of 
the datacom subsystems the MCS» and any running datacom prograas. Once 
terminatian begins» no user datacow programs are ailowed to start. 
If TERMINATE is specified the MCS does the following. 
ae Queues a message on the primary transaction queue of gach 
running datacom program. This message notifies the prograa 
that the MCS ts terminating. For a GEMCOS tnter face program» 
the message consists of the 50*byte GEMCOS header with the 
MCS“HALT“FLAG set to il. 


For a TMCS inter face program» the message consists of 
<12-bytes blanks>«xTERMINATE. 


be. Waits untit ait user datacon programs have gone to end-o f-job. 


Ce Makes alt stations not neaeye recailing and tanking any 
7 outstanding messagese 


ds. Clears the MCS queues copying. each message cleared froma the 
"CS queue to the tine printer Cif it ts available). 


ee. Notifies the SPO that the MCS is terminating. 
f. Closes files and stops. 
If TERM FAST is specifieds the MCS does the following. 


ae Clears the MCS queue» copying each message cleared from the 
MCS queue to the line printer (Cif it 1s available). 


be. Notifies the SPO that the MCS is terminating. 


ce Cioses files and stops. 
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TERMINATE COMMAND 
cont 


Following are examples of how the TERMINATE command may be used. Refer 
to the syntax diagram. 


TERM FAST 


RELATED COMMANDS. , | 
The following commands are associated with the TERMINATE coamand. 


ae HALT conmand. 
be STOP command. 
ce RESTORE command. 


TEST COMMAND 


TEST COMMAND > 

The TEST command allows users to send GEMCOS supplied or oper ator 
supplied test patterns continuously or a specified number of tim2s» to 
either an implied station or to. one or more specified stations. 


TEST COMMAND: 


TEST 7 , — : —# <Pattern # 
ALL | wrap L<integer> <text> 
’ - . 
stations4qisn> BURST—<intesger > :<text> 
<Station-Family> 
/ 


Unless the TEST command is issued by a noncontrol station that is only 
testing itself» this command is a restricted Network Control Comsand» 
and therefore may onty be issued by a control program» a control 
Stations or the controlling function. . 


If the TEST command is issued by a noncontrol station it impties only 
that stations and the options ALL» /» or stations other than the | 
issuing station may not be specified. 


If ALL or / 18 specified» alt stations not attached to user progf:ams 
or stations already being tested are tested. 


If BURST is specified» the test message is sent <integer> times to each 
station in the order specified. 


NOTE 
Dummy stations and real stations that 
are not ready may not be tested. 


If WRAP is specified» the test message is transmitted to each station 
in the specified station list. Each time a valid resuit is returned» 
the message is sent to the next station in the order specified. 


If <integer> is specified» the test continues until the test pattern is 
sent to all requested stations <integer> times. If <integer> is not 
specified» the test continues to be sent to a station(€s) until a STOPTEST 
command 18 issued» a station(s) becomes attached to a user programs or a 
transmission is unsuccessful. 


TEST COMMAND 


cont 


If neither BURST or WRAP ts specified» the test pattern its simultaneously 
sent to alt stations in the tist. If onty <integer> is specifiei» each 
time a valid result is returned from a station» the message 1s sant to 
that station again until .it has been sent <integer> times. If 

<integer> is not specified» each time a valid result is returned» the 
message 1s sent to that station again. fhe sequence ts broken when an 
unsuccessful transmission 1s encountered» or a STOPTEST command is | 
issued for the station. The sequence is also broken if the station 
becomes attached to a user program. 


GEMCOS supplied test patterns may be selected by entering SET eee 
These messages are as follous. 
ae 1 = UeeeU screen width characters 2552 or bit ere 01010101 
be. 2 = *,.e6% SCreen width characters QAAad or bit pattern 10101010 
ce 3 = a2021.-2-7E2 95 displayable characters 


d- 4 = "THE QUICK BROWN FOX JUMPED OVER THE LAZY DOGS." 46 
characters att alphabetic upper case. 


ee. 5 = "The quick brown fox jumped over the lazy dogse™ 46 
characters all alphabetic lower case. 


If a GEMCOS supplied test pattern is not selected» <test> must be 
specified. 


Following are examples of how the TEST command may be used. Refer to 
the syntax diagram. 


TEST 3 30 BURST 25 = ABCDEFG 

TEST 4 WRAP 5 #1 

TEST ALL WRAP #2 

TEST TD830XC» TO8B30XD> TD830XA #4 

TEST STATIONS 315 27 THE WEATHER IS FINE 


RELATED COMMANDS. 
The following commands are associated with the TEST command. 


@ae LT commande 


b. STOPTEST command. 
Ce TO command. 
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TO COMMAND | 


ee 


The T0 command attows aouser to send messages to real stations and the 
SPO. The syntax of the TO command is provided below. 


TO (BROADCAST TEXT TO SPECIFIED DESTINATION(S)) COMMAND: 


fe 7 
@00@ <35-byte MSG HDR sil [L > <text > 


| 


ALL —-—---— 


STATIONS ae 


<station-family > 
/ 


SPO 


The T0 command allows the user to send a message to the SPO or to atl 
specified stations. When ALL or / is specified» a message is sent 
to alt ready stations that are not attached to a user prograa. 


If a <station-family> list ts specified» a message is sent to alt 
specified stations that are ready. This occurs whether or not the 
stations are attached to a user program except in the following cases. 


ae NOACK is specified in either the RN» PL» AT» EX or ASSIGN 
commands. 


be. The TCL program section attribute NOACK is defined as true for 
the user program. , 


ce The TCL station section attribute STATIONOACK is defined as 
true for a specified station or the user program attached to 
that station. 


If TOP or TOPQ is specified» a message is sent as a priority output 
message. 


A 300a<35-byte message header> may be specified. If it is speeified>» 
then in addition to the immediate valid responses a delayed valid 
response is returned from each station for which the broadcast was 
successful. The following information is taken from the user-supplied 
message header and inserted into the actual message header. 


ae RETRY 


te TALLIES 
ce TOGGLES 
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Fotlowing are examples of how the TO command may be used. 


Examples 
TO ALL A GOOD MORNING 
TO SPO: HELP 
TO S Cole2s TOP TESTING 120356 
TOB= TOPO: ## PLEASE LOG ON #¢ 


RELATED COMMAND. | | 
The SEND command is associated with the TQ command. 


TO COMMAND 


cont 
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TRACE COMMAND 


TRACE COMMAND. 
The TRACE cogmanda eee the user to turn the trace on or off during 
MCS execution. The syntax of the TRACE command is provided below. 


TRACE COMMAND: 


— TRACE T OFF —_——$ $$ $$ ________—. 
| | | ON 
PRINTER 


SPO 


<station-name > 


The TRACE coamand 1s a restricted Network Controt Comgands and 
therefore may only be executed by a controi stations a control program, 
or the CC file. 


The default device for the TRACE command is the tine printer however, 
the trace may be output to the SPO or an active station instead. If 
the specified device 1s unavailable when a TRACE ON command is issued» 
the 4CS returns an error messagee Issuinc a TRACE ON command to one 
device when the trace is already running to another causes the output 
device to te switched. 


The trace monitors aii input and outout MCS messages» atong with 
internal MCS information. 


Following are examples of how the TRACE command may be used. Refer to 
the syntax diagram. | | 


TRACE ON TDB30XA 
TRACE ON SPO 
TRACE OFF 


RELATED COMMANDS. 
The follcwtng commands are associated with the TRACE command. 


ae GT command. 
fb. NT command. 


WMI COMMAND | 


The WMY (who Am 1) command is used to determine the name and Logical . 
number (where aoplicable) given to the user by the systeme The syntax 
of the WMI ccmmand 1s provided tetow. 


WMI_ COMMAND. 


WMI (WHO AM I) COMMAND: 


— WMI - 
STATION <isn > 
<station-name > 
QUEUE <ign>- 
2 duiewenis > | 
<mix > 


Following are exampies of how the WMI command may te used. Refer to 
the syntax diagram. 7 | 
Examples: 

WMI 

WMI 3 


RELATED COMMAND. | 7 | | > 
The WRU command ts associated with the WMI command. 


WRU COMMAND 


WRU _COMMAND. 


The WRU CWho Are You) command allows the user to determine the MCS 
name and release level. The syntax of the WRU command is provided 


below. 


J 


WRU (WHO ARE YOU) COMMAND: 
— WRU - 


Following are examples of how the WRU command may be used. 
the syntax diagram. 


Example: 
WRU 


RELATED COMMAND. 
The WMI command is associated with the WRU command. 


Refer to 


ZIP COMMAND 


a ae see - stb Gun eae: egy eae Abe ED 


The ZIP command is used to execute a specified» nonuser datacom 


pies tes The user receives a notification of the ZiPped program's 
termination when it occurs. The syntax of the ZIP command is provided 
telow. 

ZIP COMMAND: 


ant 20: tines = Ee ers 
| EX ) <disk-id > /<program-name > | <text > 


The ZIP command may only be used to ZIP a program. An attempt to @) 
ZIP an MCP Intrinsic Ceege» to ZIP other than an EXs or implied EX 


statement) causes an error. 


If the ZIP request is valid the foltowing occurs. 


ae 


He 


Ce 


GEMCOS attempts to ZIP a program caited MCSZIP. 


Program MCSZIP then ZIPs the specified program with PAUSE. 


An immediate result is returned which indicates whether or not 
GEMCOS was successful in ZIPPING the MCSZIP Progran. 


Untess the ZIP request is sent by a program which is unattached 
to the SPO» a detayed result is returned which indicates 


whether or not the specified program is successfully completed. 
A fetch value is also included. If the ZIP is unsuccessful> 
the fetch value describes the error. If the ZIP is | 
successful and the program goes to endof-jobs» the fetch value 
contains any result that the ZIPped program may want to pass 


to its initiator by way of an MPL-II STOP instruction 


parameter. 


If ZIP is sent by a task which is not attached to the SPO 
the MCSZIP does not send a delayed message to the progran. 

An error message is disptayed indicating that the SPO is not 
attached. The SPO output -is used to determine whether or not 
one 21Pped program was completed. 


pacauae MCSZIP sends its final response to the MCS by 72Ping 
a DC TU <station=name> <text> commands the message T0 OK 15s 
always displayed on the SPO and should be ignored. 


NOTE 
An indication of success means that the 
desired program was successfully executed. 
Tt does not indicate whether or not the 
specified program successfully per formed 
its function. 


Z1f COMMANC 
cornet 


Following are exanples of how the ZIP command may be usede Refer to 
the syntax dtagram. 


Examples: 


ZIP RM OLODFILE 


ZIP CH NEWFILE TO OLDFILE 


RELATED COMMAND. 
The TO command is associated with the ZIP command. 
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SECTION 9 


TRANSACTION CONTROL LANGUAGE 


TFANSACTION CONTROL LANGUAGE (TCL). 


at <n a ae AN tN EP wep NN ES AE a ee aD OO GD CE ED Oe ee ee ae a ee ae a ee a 


The Computer Management System (CMS) Transaction Controt Language 

(TCL) is classified as a high-tevel descriptive language. The Trans- 
action Control Language provides a simple method for. selecting required 
Message Control System (MCS) functions» and for descriting the or-line 
network relationships. 


Fach TCL statement descrites some portion of the onstine system: the 
users» the programs» the stations or the MCS.~ These individual state- 
ments are compiled by the MCS generator (1.e.» the TCL compiler or 
*CSGEN) creating ar MCS program used to control the desired environment. 


If the requirements of the MCS or the system relationships with which 
the MCS operates change» a new system may be easily obtained by 
recoapiling to generate a new MCS. 


Refer to the cus [Transaction Control 


SECTION 10 


FORMATTING 


In order to isotate terminai-dependent functions and remove them from 
the applications CMS GEMCOS supports on-line message formatting. The 
CMS GEMCOGS formatting module permits fast» automatic reformatting of 
messages for programs and terminals. 


GENCOS formats are created using the CMS Format Generator» an inter= 

active program for creating and maintaining on-line messace formats. 
Refer to the CMS Format Generator User's Guides form 1114634. 

The format generator allows declaration» compilations and testing of 

formats without interrupting other processing» and atltows new formats 
to te defined and old ones to ke changed without halting the network. 
The format generator runs tn NONPARTICIPATING mode under CMS GEMCOS>» 

and requires no special TCL description. 


INPUT _FORMATS: | 
Input formats are used to format messages for transmission to a program 
and are requested ty the operator with every message entered. Column 1 
of the message must be the station’s control characters» fottowed by the 
name of the format and the data. The format name must be 12 characters 
longs teft-justified and space filled as indicated below. | 


*MYFMTNAME <this is the data being formatted>~ 


sanwenraea] -@ aeanean a) oe ee eet gee ae 


When an input format is recognized» the message is formatted before any 
routing is done. This attlows a transaction code to be inserted by the 
format. Programs cannot make input format requests. 


QUIPUT FORMATS. 

Cutput formats are used to format a message for dvsptay on a terminal. 
GCutput formats may be requested by an operator in the same way as input 
formats» or by a program through a special data structure as follows. 


C1 FORMAT“REQUEST REDEFINES OUTPUT “MESSAGE “BUFFER. 


02 MCS“MESSAGE“HEADER PIC xX(50). 
O03 FILLER © PIC X€29). 
03 MCS -FORMAT= REQUEST -FLAG PIC 9. 
93 FILLER PIC XC20). 
O02 FORMAT@“STATION | : PIC X€1i2). 
02 FORMAT“NAME PIC X(12). 
O02 FORMAT“DATA | ee PIC X€C???7). 


FCRMAT-“STATION tis the name of the station where the message is teing 
sent. FORMAT*NAME is the name of the format being used» and FORMAT= 
DATA is the data being formatted. Once filled ine MCS“FORMAT-REQUEST=- 
FLAG should be set to i and the message shoutd be sent to statton 

MCS as follows Cusing data names refered to in section 5). 


MOVE 1 TO MCS“FORMAT“REQUEST “FLAG. 


MOVE "MCS" TO OQUTPUT“STATION“NAME,. 
SEND QUTPUT<“CO FROM QUTPUT?*MESSAGE“BUFFER WITH EGI. 
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FORMS _REQUESTSs: 


Foras requests are output eaeaats which do not involve any data» and 
are used to cali a biank fora to the screen. Atl data fieids in a 
forms request are automatically filled with spaces. When entered froas 
a station» a forms request does not require traitting spaces fotlewing 
the format nage. 


ERROR HANDLING. 
GEMCOS formatting is ordinarily transparent to the applications program. 


Formatted messages sent to participating prograas contain the usuat. 
GEMNCOS header. Messages sent to nonparticipating prograas consist of 
gBessage text atone. 


In the event the formatter detects an error from an operator or @ 
program» three actions are taken as follows. 


ae Monitor stations are notified of output errors. 
b. The message ts formatted as well as possibte. 
Ce The sessage is delivered if possible. 


yt “he: ecebat iavsived is an input. Sereste the message is detivered 
with a diagnostic header attached. This header contains the name of 
the forsat and the type and location of the error as follows. 


O01 FORMATTED“MESSAGE REDEFINES INPUT“MESSAGEBUFFER 
. (02. MCS“MESSAGE“HEADER. 


03 FILLER | | 
03 «FILLER | PIC X€30). 
03 MCS-FORMAT-ERROR=FLAG PIC 9. 
| 03 FILLER PIC X19). 
02) ~FORMAT“ERROR“HEADER. 
| 03 FORMAT-STATION PIC X€12). 
03 FORMAT“NAME PIC X(12). 
03 FORMAT@ERROR“NUMBER PIC XC€3). 
03 FGRMAT“ERROR“LOCATION PIC X(5). 
O02 FORMATTED<DATA PIC X(2727?). 


In the case of an errors INPUT“STATION“NAME is set to MCS in the 

input CDs» and the MCS“FORMAT“ERROR=FLAG is set to 1 in the GEMCOS 
header. FORMAT“STATION contains the nawe of the station which sent 

the messages FORMAT“NAME contains the nage of the format used» 
FORMAT“ERROR“-NUMBER contains a forratting error nuaters and 
FORMAT*ERROR“-LOCATION contains the position in FORMATTED<-DATA of 

the character which caused the error. FORMAT“ERROR@“LOCATION can range 
from zeros indicating the first character of data» to ?72- 1s indadcating 
the tast. 
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SECTION 11 


AUDIT/RECOVERY 


CMS GEMCOS audits messages into a series of 100 disk files called an 
audit trail. Each file in the audit trail shares a common root file 
name» and 1s assigned a 2-digit suffix which makes it uniques An audit 
trail with a root name ot “MCSAUDIT"» for examples» would consist of 
fite names “MCSAUDITOO" through "MCSAUDIT99". The MCS creates a new 
fite in the audit trail whenever the existing file is full» or whenever 
the MCS 1s executed. When file "99" has been filleds the audit trail 
suffix returns to "00". | 


Each message in the audit file requires 90 bytes more than the actual 
message tength. For examples the message 


Peter Piper picked a peck of pickled peppers 


senagwaaa) saan} eee =? men ne fo en jmeevaejzovuen{oawaey 


would require 133 bytes in the audit file: a 3*byte audit header» 
a 35-bHyte NDL headers» and a SO-tyte GEMCOS header ptus the 45-bytes of 
message text itself. 


The audit file itself consists of packed» unblocked i8CG=“byte records. 
To choose the best number of records to aliocate per file» users shoutd 
compute the following: | 


180 | 


This number can be supplied to CMS GEMCOS through its Transactton 
Control Language (TCL). 


Transaction-based routing programs are audited by CMS GEMCOS on the 
basis of their transaction codes (trancodes). By specifying individual 
trancodes as audit transactions» messages can be audited on the basis 
of their use. If XYZ were an audit transaction» for exaaples ail 
@essages containing that trancode would be audited by the MCS. 


Fixed assignment programs are either completely audited by CMS GEMCOS 
or completely unauditeds there is no partiat or selective audit for 
assignment. An audited program using dynamic assignment has its entire 
input audited» regardless of origin or use. | 


The audit capabilities of CMS GEMCOS do not extend to host-resident 
programs whether they use transaction=based routing or not. The only 
candidates for CMS GEMCOS audit are input messages for participating 
CMS programs. By the same token» Interprogram Communication CIPC) 
cannot be audited. | 


Recovery in CMS GEMCOS is a gtobal process» in which audited messages 
are redelivered to the programs which originally received them. 
Recovery may be initiated from anywhere in the audit trails» and may be 
terminated at the end of any subsequent message. 
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Programs with messages in the audit tratt are automatically restarted 
by GEMCOS during recovery» supplied with a datacom queues and notified 
that they are running in recovery mode. The MCS redelivers atl 
messages in their original order» and notifies each program when 
recovery is complete. The network is then resenabled for operator 
inputs and noraal processing is automatically resumed. 
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Whenever CMS GEMCOS 1s executed» it automatically creates a new audit 
fite. Audit files may also be created in mid"run. 


Every message audited is assigned a unique 7*digit sequence numter which 
is used during recovery. This number is passed to the progran in MCS- 
SEQUENCE“NUMBER along with the message. The first and taSt sequence 
numbers in the audit file are printed whenever a new file is opened or 
closed as follows. 


** AUDIT FILE AUDFILEO1 CREATED 
xx FIRST SEQUENCE NUMBER IS 9109008 


we AUDIT FILE AUDFILE®1 LOCKED 
ee LAST SEQUENCE NUMBER 15 G160123 


NOTE 
Any program with AUDITINPUT also has the 
following administrative wessages audited: 
ASSIGN» BROADCAST» CLOSE» HALT» LOGON» 
LOGOFFs QUEUE ALLOCATED CEQ)» QUEUE 
ATTACHED (CAQ)>» TASK DETACHED» and VACANT. 


RECOVERY PROCEDURES. 
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CMS GEMCOS recovery is initiated when the MCS is executed as follows. 
EX GEMCOS RECOVERY 


| NOTE 
tf the MCS abnormatly terminates while 
auditings the next time the MCS 15 
ctrought up the user is asked if recovery 
is desired. Also» the HALT command can 
be used to request recovery. Refer to 
the HALT command in sectton &. 


This informs the MCS that recovery is in progress. 


When the MCS is executed in recovery mode» it does not enable the 
network (i.@.s ready the Lines) until recovery is coaplete. Instead» 
the MCS requests which Wee arcs should be recovered as follows. 


** PLEASE ENTER RECOVERY RANGE "DC NNNNNNN@ NNNNNNNN® 
DC C100019°920916G 


The sequence numbers specified are audit sequence numbers - In this 
case» the MCS BEGIN recovery with message 69913 in audit file AUDFILE31 
and ends with meSsage 99160 in AUDFILEC2.» Had "END™ been specified 
instead of %290160» the MCS woutd have recovered to the erd of the 
audit trail. QGnce these messages have been successfully delivered» the 
operator is allowed to restart the normal network as fotlows. 


ee PLEASE ENTER "OC Y" TO BRING UP THE NETWORK 
* OR ENTER "DC N”™ TO STOP 


If the answer is Ys» a new audit file is created and the network is enabled 
(brought up). Programs defined as EXECUTE=BO0OJ are rewexecuted if not 
already running» and normat operation is’resumed. If the answer is Ne» 

the MCS halts and all applications are sent termination aessages. 


when the MCS reads a message from the audit file during recovery» it 
determines if the program is up and running.»j If it is» the message is 
sent. If nots» the program is ZIP-executed and allowed to attach, | 
If a program cannot be executed» the operator is notified and asked 

for instructions as follows. | 


**PROGRAM ABC. CANNOT BE EXECUTED 

** PLEASE ENTER "AX <MIX#> Y¥™ TO TRY AGAIN © 
te GR ENTER "AX <MIX#> N* TO STOP 
QL/GEMCOS ACPT 


If the operator enters a Ys the MCS continues to attempt execu™ 
tion. If the operator responds with an Ns however, the MCS 
terminates. 


The application recovery interface to ome GEaMCcOS is ‘abealded in the 
MCS neader as foltows. 


O1 MCSHEADEF. 


G2 MCS@PFACTICE@MODE PIC 9- 
92 MCS*TRANDATA@1 PIC 9(5). 
02 MCS“TRANDATA=2 | PIC 9(5). 
32 MCS@STATION@DATA PIC 9(35)- 
92 MCS*HALT “FLAG PIC 9. 
G2 MCS“RECOVERY@"FLAG ~ a ee PIC 9. 
O02 MCS*CONTINUE“FLAG PIC 9. 
22 MCS*SEQUENCE*NUMBER | PIC 9(7), 
Q2  MCS*ASSIGN-FLAG PIC 9. 
92 wCS-CLOSE-FLAG PIC 9. 
92 MCS-BROADCAST-“FLAG | PIC 9, 
O02 MCS*FORMAT"REQUEST=FL AG , 3 PIC 9. 
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92 MUS*FORMAT*ERROR@FLAG - pic 9, 


$2 “MCS“NETWORK=CONTROL“COMMAND<“FLAG PIC 9. 
92 MCS*INTERNAL-FORMAT-FLAG PIC 9. 
02 MCS“DELAYED“MESSAGE=FLAG ~ Pic 9. 
02 MCS"“LOGON-MESSAGE-FLAG PIC 9. 
02 MCS“LOGOFF-MESSAGE“FLAG PIC 9. 
O02 MCS“ENABLED=QUEUE (CEQ) <FLAG PIC 9. 
G62 MCS*ATTACHED“QUEUE CAQ)=FLAG PIC 9. 
92 MCS*TASK*DETACHED@FLAG PIC 9. 
02 MCS=VACANT“FLAG PIC 9. 
962 MCS*TRANCODE“FLAG PIC 9. 
02 MCS"“MODULAR=FLAG PIC 9. 

Length 

mn 
Field | Bytes 


PRACTICE mode flag 

TRANSACTION DATA 1 
TRANSACTION DATA 2 
STATION DATA 

HALT FLAG. 

RECOVERY FLAG 

CONTINUE FLAG 

SEQUENCE NUMBER 

ASSIGN FLAG 

CLOSE FLAG 

BROADCAST FLAG 

FORMAT REQUEST FLAG 
FORMAT ERROR FLAG 

NETWORK CONTROL COMMAND FLAG 

INTERNAL FORMAT FLAG 
DELAYED MESSAGE FLAG 
LOGON MESSAGE FLAG 
LOGOFF MESSAGE FLAG 
ENABLED QUEUE (EQ) FLAG 

ATTACHED QUEUE CAQ) FLAG 
TASK DETACHED FLAG 
VACANT. FLAG 

TRANCODE FLAG 

MODULAR FLAG 
(reserved) 
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MCS“RECOVERY"“FLAG indicates the processing mode of the network: "4" 
indicates normal mode» and "1" indicates recovery. By monitoring MCS- 
RECOVERY*FLAG+ programs can determine the mode in which they should 
operate. | - 


MCS*SEQUENCE“NUMBER is the sequence number assigned by CMS GEMCOS to 
every message it audits. . Unaudited messages have MCS"SEQUENCE“NUMBER 


set to spaces. 


(Lins 


Whenever CMS GEMCOS delivers a message during recoverys tt always waits 
for the program to process it before delivering the subsequent message. 
To notify the system that recovery may proceed» programs should return 
an MCS header with MCS“CONTINUE“FLAG set to "1" as follows Cusing data 
nanes refered to in section 5). | 


RECEIVE INPUT*CD MESSAGE INTO INPUT“MESSAGE= BUFFER. 
IF MCS*RECOVERY"FLAG = 1 THEN 
MOVE 1 TO FCS“CONTINUE*FLAG 
MOVE 59 TO OUTPUT“MESSAGE*LENGTH 
MOVE INPUT-“STATIGN*“NAME TO OUTPUTSSTATION“NAME 
SEND OUTPUT-*CD FROM MCS“MESSAGESCHEADER WITH EMT. 


Since the MCS waits for permission to continues this should generally 
te done immediately after the RECEIVE ta maximtze throughput. 
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SECTION 12 


PRINTERS AND TERMINALS 


AP3O0 DATACON PRINTER.» | | 

The AP300 datacom printer is not an output only device. If the AP300 
status changes» the AP300 automaticaily sends a status rmgessage to the 
MCS3 the MCS stores this status message. 


The AP300 must be specified in the station section of TCL. <Atsos the 
progras section attribute AP3OOSTATUS must be defined as true so that 
programas attached to an AP300 station may receive AP300 status 
#essagese 3 


HNIO90_ TERMINALS 2 

The Modutar Terminal Cor soft tersinat) is a forms processing systen. 
A form is created tocal to the terminal atong with a program to direct 
the processing of the form. This forsg is then stored on aremote file 
system lLocat to the terminal or stored on the host processor (which 
may be toaded at a tater time). White a form is executing» the 
program aay direct atl of the forms data fieids or setected fietds 

be sent to the host. In the same way» the form may receive atl or 
part of its data fietds. The Command Message (C/M) area is an area 
avaitabie for direct comaunication with the host processor. 

Special headers and tratters have been designed to precede and fottow 
gessagese The headers indicate the type of text being sent or 
received. Ali messages from the MIT600 Cexcept for Command Message area 
messages) have headers and alt messages to the terminal must be 
preceded by headers. Also» all sessages (except for Cosagand Message 
area messages) aust be fotlowed by the special traiters. 


Fottowing are the headers and the trailer used by the MT600. 


First Second Third 
Character Character Character Meaning 


Headers 
DC4 2 DCL == Sending and receiving forms. 


DC4 | 4 obCcl Receiving of sending até foras 
| data fields. 


OC4 6 DC1 | Receiving or selecting 
selected fieid yvyaiues. 


bCc4 . 3 DCi Load and run. 


iz? 


First Second Third 


| Character Character Character Meaning 
BC4 rf | BDCi Recovery point message. 
DC4 8 | OCi Continuation buf fer inddcation 


(forms onty). 


Irailer | 
DCA E DCi Logicat end of a messagé. 
EYX | | Physical end of a message. 
No header | Sending and receiving messages 
or trailer | from the Coamand Message (C/™) 


afr eae 


TERWNINAL INTERFACE. 

The Modutar Tersinal interface is not compticated. GEMNCOS strips 
headers and traiters on input (to the MT600) and adds thea on output 
(from the MT600). <A header consists of a 3 bytes? the first byte is 
DC4 and the third byte is DC1. The second byte is one of the 
following: "2"%>» "3% “"4"%s “6"%» "F"> or “8". Handling of Modular 
Terminat System (MTS) formas is not a consideration in this retease. 


Using the TCL attribute STATIONTYPE a station may be defined as an 
MT60G. A imbyte fietd Ci.~e. MCS“MODULAR-FLAG) within the SO-byte@ CS 


header is used to communicate the message type to and. from peereatrce 
prograas. 


PROCESSING MESSAGES FROM THE MI600. 

Messages from a MT600 are examined by GEMCOS to determine whether or. 

not a header and traiter are present. If a header and trailer are 
present Gemcos strips them from the message before processing. Fwo 

flags are then set in the 5Sd-byte MCS header. The MCS“MODULAR=FLAG isS 
set to the value of the second byte of the MT600 header. The MCS-MODULAR~ 
TRAILER FLAG is set to ls» indicating that the current message is complete 
and that a trailer was stripped. If there is no trailer on a message 

the MCS"“MGDULAR@FLAG is set to zero. This indicates that a part#at 
message was sent and that sore data will follow to coaptete the togicat 
mESSaAge « 


When messages from the Command Message (C/M) area are received» GEMCOS 
sets the MCS“MOQDULAR<“FLAG and the MCS“MODULAR<“TRAILER to a vatue of 
zero. This indicates that the message is from the command message 

are and that no header and trailer are present. 
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PEQCESSING MESSAGES TO THE MI600~ 

Messages from a progran to an MT690 are examined by GEMCOS. GEMCOS 
axamgines two flags in the MCS 5S6"*byte header» the MCS*MDDULAR-FLAG and 
the MCS“MODULAR@TRAILER. If the value of the MCS“MODULAR@FLAG is 

zero the message is sent to the MT60G without a header or trailer. If 
che MCS-MODULAR“FLAG is set to "2%» "3% The “H%> "Fe or NE"s the 
MT60¢ header is attached and the value of the MCS*MODULAR“TRAILER ftag 
is checked. If the value is "17 a tratler is also attached and the 
message is sent to the MT660. If the vatue of the MCS"-MODULAR“FLAG is 
not "2%— *3%—2 "4% 5 "6%> RW7%, Or “B"» the message is rejected by the MCS 
and an error message is returned. 


APPENDIX A 


ERROR MESSAGES 


ae ee, a caren <a 


This apuendex (table Aw1) lists alt the error messages retated to the 
GEMCOS$S commands. The first two columns on the left tist the message 
number and the actual message as it is disptayed. The GEMCOS command(s) > 
that evoked the error are listed in the third column with the associated 
fetch value. The reason for the error and recommended corrective 

action are indicated in cotuans 4 and 5. For some commands a specific 
reason and action may applys they are tisted last in the description 

for the error message. | 


The fetch value is sent to the program Communicate queue for diagnostic 
purposes. | nsists of xadecimal digits): The 
first ba i Selaay digits) is au? aoc an error response. 

The china TT see Ve di Ss 


message. 


APPENDIX A (cont) 
 TFabte a-i 

Error Message Table 

ASSOC e 

Cosaand/| 


Fetch 


Message Vatue Reason | Action 


100 {SYNTAX ERROR - PLEASE AP 300°- Syntax error(s) or | Correct and re-enter 
TRE“ENTER. ~ | STATUS/ extraneous text (remove extraneous 
303506 was entered. text). 


ASSIGN/ 
30 3000 


AT/ 
30020D 


BREAK/ 
30 0B06 


cc/ 
302A05 


CHANGE/ 
30 3100 


APPENDIX A €cont) 
Table A-1 (cont) 


Error Message Tabte 


ASSOC. 
Command/ 
Fetch 
Message Reason 


CONF/ 

300C01 
DETANK 

303400 


DIALINZ 
301101 


DIALOUT 
301101 


DISCON- 
NECT/ 
| : 301201 


or 
301F06 


i 


APPENDIX A Ccont) 
Table A-1 (cont) 
Error ‘Message Tabie 


Assoc. 
Comgmand/ 


Fetch _ 
Message Value Reason ' Action 


EX/ 
360100 


GT/ 
300801 


HALT / 
30 3800 


LL/ 
302303 


LOGOFF / 
36 390C€ 


LOGON/ 
30 3A00 


MERGES 
303800 


MX/- 
300600 


NT / 
300901 


G-¥ 


APPENDIX A Ccont) 
Table Aw-i1 Ccont) 


Error Message Table 


ASSOC. 
Cosmand/ 


Fetch | | | 
Message Vatue Reason Action 


NY/ 
301506 


OL / 
301300 
or 
301302 


PL/ 
3900400 


PR/ 
3007901 


PRACTICE/ 
303C00 


RESTORE/ ' 
303200 


RL/ 
300E01 


RN/ 
300300 


9-V 


APPENDIX A Ccont) | 
| Tabte A-1i (cont) 


Error. Message Table 


Assoc. 
Command/ 


. . Fetch 
Message Vatue Reason 


ROs The first option has Correct speiting. 
302701 been misspelled. 


RS/ 
300F 01 
oF 
~—300F04 


RUNZ 
303D00 — 


EEA AIK IS 


RY¥/ 
301406 


SEND/ 
303E00 


SET/ 
301D06 


s0/ 
502601 


STATUS/ |. 
3C3F00 


STOP/ 
304000 


ZoV 


APPENDIX A Ccont) 
Tabte A-i (cont) 


Error Message Tabte 


Assoc. 
Coamand/ 


| Fetch | 
Message Vatue Reason 


Action 


TERN 
302200 


TRACES 
304200 — 


Tos 

301801 
or 

301802 


ZIPZ 
301B01 


101 | USAGE RESTRICTED TO CC/ This command was Re-enter the command fror 
? | CONTROLLERS 3Z02AFF issued from a non~ — a controtter. | 
| control source. The 

CF/ command gust originate 
30 OAFF from a controt stations | 
| acontrol programs a 
CHANGES controliing function» 
3031F F or the CC file. 


APPENDIX A (cont? 
Tabte A-1 (cont) 


frror Message Table 


ASSOC. 
Coasand/ 
MSge Fetch 
Noe Message Vatue | Reason : Action 


‘302 1F | 


CLOSE/ 
3033FF 


CONF / 
Z00CFF 


DETANK/— 
3034FF 


DIALOUT/ 
301101 


DISCON- 
NECT/ 
301201 


1) 
300503 


pUMP/s. 
3036FF 


GT/ 
3008FF 
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| APPENDIX A Ccont) 
Table A-1 (cont) 


Error Message Table 


ASSOC. 
Comamand/ | 


Fetch . 
 Messace Value — Reason | Action 


HALT/ 
36 38F F 


LL/ 
3O023FF 
LT/ 
| | 30 25F F 


MERGES 
30 3BF F 


NTS 
3009F F 


NY/ 
30 15FF 


PRI 
300705 __ 


PRACTICE/ 
30 3CFF 


[Ros 
301002 — 


RECALL/ 
3020F F 


OT-¥ 


APPENDIX A Ccont) 
Tabte Awl Ccont) 


Frror Message Table 


ASSOC. 
Command/ 


Fetch | 
Vaiue Reason — Action 


Message 


RESTORE/ 
30 32FF 
RLS 
Z00EFF 


RO/ 
3027FF . 


RS/ : 
300FFF 


RUN/ 
30 3DFF 


RY/ 
ZO1L4FF 


SEND/ 
303EFF 
SET/ 
301DFF 
SO/ 
3026FF 


LEP. 


1202 


APPENDIX A Ccont) 
Fable a1 (cont) 


Error Message Table 


} Assoc. 
| Commands 


| Fetch 
Message : Vatue 


Reason Action 


; STOP/ 
SG40F F 


TERM/ 
~3022FF 


TRACE/ 
S042FF 


STATION <statton name> | CLOSES A dumay station i.e.» [Specify a reat station. 
PNOT DEFINED IN TCL | 303302 iCC+ DC» SPO» MXn) was 


| specified. This 
DETANK/S [command onty accepts 
30 3402 real stations. 


| PRACTICE/ 
| 303002 


STATUSS | 
| 303F02 


APPEADIX A Ccont) 
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Table Aw-i (cont) 


Error Message Table 


ASSOC. 
Comaand/ 


Fetch 
Message Vatue Reason Action 


(yids LINE <togical Line CE / | A Logical line number Enter a correct logical 


number> INVALIC 300AC4 not defined in NOt was|{ line number. 
| entered. 
CONF / 
300C01 
DIALOUT/ 
301101 
DISCON- 
NECT/ 
301201 
STATUS/ 
303F 03 | 
1104 |PRINTER NOT AVAILABLE GT/ | The Line printer is in| Ready the line printer or 
30C8CE use or 15 not in the | request the trace to be 
ready mode. sent to tha event tog 


C(EVLOGFILE). It can then 
be printed when a printer 
becomes available. Refer 
to the LiL command in 
section 8. 


@ 


ST-¥ 


¥Sg 
No. 


105 


106 


ic? 


Table Awl Ccont) 


Error Message Table 


Assoc. 


‘Command/ 


Message 


Fetch 
Value 


LL/ 
302308 


RECALL/ 


LOGON NOT REQUIRED 
AT THIS STATICN 


PROGRAM CANNOT BE RUN 


- TEXT > 255 CHARACTERS | 


LOGON REQUIRED AT 
THIS STATION 


302000 


TRACES 
304204 


LOGON/. 
303A05 


RUN/ 
30 3D06. 


ASSIGN/ 


SO 30FF 


AT/ 
S002FF 


ccs 
302 AFF 


Reason | 


The Cine printer is in 
use or is not in ready 
mode. 


This station does not 
ijrequire a togon 
(according to the TCL 
description). 


‘|The issued text is too 


long. 


This station is not 
logged one (Cit is an 
access-controltl station 


jas defined in the TCL.) 


key and» 


APPENDIX A (cont) 


Action 


|Check the line printer and 


re-enter uhen printer is 
available. 


None. 


Reduce text tength not 
to exceed 255 characters 
and rew~enter. 


Log on with vatid access 
if necessary» 
passwords then re-enter 
the command. 
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APPENDIX A Ccont) 
Table A-1 (cont) 


fFrror Message Table 


ASSOC. 
Coasand/ 


Fetch | 
YVatue — Reason. | Action 


Message 


Crs 
SOQ AFF 


CHANGES 
| 3031FF 


CLEARS 
3021FF 


CONF / 
3SCOCFF 


DE TANKS 
SO 345FF 


DISCON~ 
NECT/ 
3012FF 


DUMP/ 
3036FF 


EX? 
3001F F 


GT/ 
3008F F 
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APPENDIX A C€cont) 
Table A~1 (cont) 


Error Message Tabte 


ASSOC. 
Consand/ 


Fetch | 
Message Vatue Reason | Action 


HALTS 
30 38FF 


Lis 
3023FF 


LT? 
30 25FF 


MERGES 
30 3BFF 


NT/ 

30 09FF 
NY / 
SOLSFF 
Pis 
30 04F F 


PRS 
300705 


PRACTICES 
SO3CFF 


GT=V 


APPEADIX A (cont) 


Message > 


Table A-1 (Ccont) 


Error Message Table 


Assoc. 
Command/ 


Fetch | | 
Vaiue Reason 


RD/ 
301002 


RECALL 


3020F F 


RESTORE/ 
30 32FF 


RL/ 
3SOQ0O0EFF 


RN/ 
3003F F 


RO/ 
3027FF 
RS/ 
300FFF 


RUNS 
303DFF 


RY/ 
301L4FF 


LV=V - 


| | APPENDIX A (cont) 
Table Ami Ccont) 


Error Message Table | 


ASSOC. 
Commands 


Fetch | | 
Vatue | Reason Action 


SEND / 
303EFF. 
SET/_ 
3C1LDFF 


SO/ 
3O26FF 


STOP/ 
—3040FF 


STOPTEST/ 
3O19FF 


TERM/ 

3022FF 
TEST/ a 
Z01AFF : 


TRACES 
304&2FF 
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APPENDIX A (contd 


Message 


Table A~1 Ccont) 


Error Message Tatle 


ASSOC. 
Comamand/ 
Fetch 


Vatue Reason 


Action 


11¢@ |CANNOT ASSIGN PROGRAM 
i¢program name> - HALT 
IN PROGRESS 


[109 | PROGRAM <program name> 


CANNOT BE ASSIGNED - 
NQT RUNNING 


| ASSIGN/ 


ATS 


ASSIGN/ 


| This command was 
| entered following a 
TERM or HALT command. 


393008 


300216 


EX/ 
300118 


PL/ 


300418 


RN/ 
300318 


This program is de- 

fined in TCL as not to 
| be executed on demand. 
AT/ q7 A program can be de- 


303009 


300209 clared to be executed 
| | on demand» executed 
EX/ | manually or automati- 
300109 cally by GEMCOS at 
. | Beginning-of~Job. 

PL/ 
300409 
RN/ 


3003509 


{Wait for the 4CS to go | 
[to Endeof-Jobs restart the j 
TMCS» and retenter the | 
icommand. 


{Manually execute program 

ibefore entering an assign 
fFcOommands 
ivalue of the TCiL attribute | 
FEXECUTE and regenerate the } 
i MCS. : 


or change the 


APPENDIX A Ccont) 
Table Aw-1 Ccont) 
Error Message Table 


ASSOC. 
| Command/| 


Fetch 


Message Vaiue 


Reason Action 


110 |YCU ARE NOT AUTHORIZED] ASSIGNS An attempt was made to | Ensure that the station 


TC ASSIGN PROGRAM 30300A assign this program requires a tog on and is 
<prograe name> 7 from a station that logged on by a valid 
AT/ was not signed on by a ] assigner. 
30020D vatid assigner. 
| (Valid assigners are 
EX/ specified in TCL for 
30010D a program.) 
PL/ 
| 300400 
| RN/ 
300300 
111 | CONCENTRATORS CANNOT “ASSIGNS An assign command was None. 
BE ASSIGNED 303008 performed from a 
| | station that is 
| ATS ceclared in TCL to be 
3002CD a concentrator. 
| EX# 


300100 


6T=V 


 Oc=V¥ 


APPEADIX A Ccont) 
Tabttile A-i Ccont) 


Error Messace Table 


ASSOCe | 
Command/ 


Fetch 
Vatue Reason Action 


Messace 


PL/ 
300400 


RN/ 
30030D 


1112 |HCSTS CANNOT EE ASSIGN/ | An assign command was None. 
(ASSIGNEG 30300C performed froa a 
Station that 1s 
AT/ | declared in TCL to te 
30020D a host. 


EX/ 
30010D 
PL/ 
30040D 
RN/ 
300390. 


APPENDIX A Ccont) 
Tabte A-1 (Ccont) 


Error Message Table 


ASSOC e 
Command/ 


Msg. Fetch 
NO Message | Vatue 


Reason | Action 


1413 | CATACOM TASK NOT BREAK / No datacom task is Verify the status of the 
1 RUNNING AT MIX NUMBER 300801 assigned to this mix tasks in the mix to ensure 
<mix nueber> or inumber. that it is runntng. 
| 300302 | 


GT/ 
300808 


NT/ 
300909 
PR/ 
300702 
114 | SPO CANNOT BE ASSIGNED | ASSIGN/ The Control Station Omit SPO or DC from 
3G300€E | \CSPO or DC) was speci~ | the Station list. 
fied in the station | 


AT/ list for an ASSIGN 
30020D command. 


EX/ 
300100 


PL/ 
300400 


RN/ 
| 30030D 


Té=V 


Table A-1 (Ccont) 


Error Message Table 


ASSOC. 
Comaand/ 


j1 16 


‘i117 


119 | 


Message 


STATION <fogicat 
station number> CANNOT 


; RECEIVE BROADCAST = 


NOT READY 


STATION <logicatl 
station number > 
/<station name> NOT 
CN A LINE 


CC DENIED - IAVALID 


FROM A CC INPUT FILE 


LPN <logicat processor 
number> TOQ LARGE 


STATION <fLogicat sta- 
tion nusber>/<station 
name> ATTACHET 


Fetch 
Value 


SEND/ 
30 3E0F 


GT/ 
300810 


NT/ 


300916 


CC/ 
30 2AFF 


CF/ 
300A03 


T0/ 
301800 


Reason 


The specified Station. 


1s not readye 


The specified station 
1S a dummy station and] 


does not apply. 


CC command issued by 
a CC file. 


The togical processor 
number ts not defined 
in NCL. 


The TQ coamand cannot 
be performed because 
the station is already 
attached to a user 
task. : 


Action 


Ready the station or 
specify another station. 
Refer to the RY command in 
section 8. 


Specify a real station. 


Remove CC command froma. 
file. 


Check and correct the 
logical processor number. 


None. 


APPENDIX A Ccont) 
Table A-1 (cont) 
Error Message Table 


| Command/ | 


| Fetch 
Vaiue 


Reason | Action 


120 |JREQUEST DENIED = ONLY PRS | If a station or a Address the station 


VALID FROM A STATION 300705 | task is not addressed» | automatically using the 
: then the PR command. Station clause. 
must be entered at a | 
“Station. 
fi2gl [STATION <togical CLOSES | Station <station name> |Correct station name 
, istation number>/ 303315 is not currently fand re-enter. If a sta- 
i<station name> IS NOT attached» so a detach j{tion is attached to a 
ASSIGNED | is not possible. This [programs the station may 


Station may be attached|not be detached. 
to a task which is 

defined in TCL to use 

ATTACHMENT routing and 

this routing may not 

be revoked. | 


123 [BROADCAST MESSAGES SEND/ A station specified to {Specify a different 
CANNOT BE SENT TO 30 3E1F receive broadcasts is station. 
[HOSTS . a host. — 


tcoV 


¥ZuV 


APPENDIX A Ccont) 
Table Aw-1 Ccont) 
Error Message Table 


ASSOC. 
Cosmand/ 


Fetch 


Messace Value Reason | Action 


| 124 | STATION NOT ATTACHED [| BREAK/ The station is not Re-enter the break at 

| | 300803 jattached to the task fa station which is 
to which the break is fattached to the task. 
ibeing sent. 


1125 | MULTIPLE BREAK | BREAK 1A prevtous break GWait for task to process 
: 1MESSAGES ; | 300BD4 }message to the same fprior break message» and 
: itask is stilt waiting ithen re-enter the SREAK 
to te processed by the [command. 
jtask. Only one break 
fmessage is permitted. 


1127 | TASK MAY NOT FECEIVE | BREAK iThe task is defined, ifInsure that task Is 
= iA BREAK 300B05 either by default or icorrect. If task its 
| explicitly tin TCL using{fcorrect change the vatue 
the BREAKALERTS attrib-fof the TCL attribute 
utes not to receive a BREAKALERTS. 
ibreak message. | | | 


Be: (TEXT TOO LONG | ZIPs |The text being zipped |Re-enter using a text of 
| | 301801 is longer than 995 fless than 996 characters. 
: characters. | | : - : 
1130 |SITENIF FILE NOT | ory | the Site Information  [None. 
: ;AVATLABLE | 301302 iFite MCSTITENIF is in 3 


fuse or not present. 


Table A-1 (Ccont) 
Error Message Table 
AsSOC. 


Command/ 
Fetch 


Message | Vatue Reason 


}i34 | STATION <station name>/|ASSIGN/ |The specified station 
<station number> CANNOT] 30301F is not defined in NOL 
BE ASSIGNED - NOT ON | | and therefore cannot 
A LINE | AT/ be assigned. 
3 300200 7 | 


EX/ 
300100 


PL/ 
300400 


RN/ 
30030D 


1133 | QUEUE <queue name> ASSIGN/ The specified queue 
IS NOT A VALIC QUEUE | 3030621 name is not defined 
NAME , in NDLe 
| AT/ os 
300203 


EX 
300103 


GIs 
300804 


NT/ 
300904 


Geo¥ 


APPENDIX A Ccont) 


Define station tn NOL or 
correct entered station. 


Correct the name or 
specify another queue 


‘name. 


haeee. 


APPENDIX A Ccont) 


Tabte A-1 Ccont) 


frror Message Table 


| ASSOC. 

Coaaand/ 
| Fetch 7 
Message - | Vatue. Reason | | Action 


PL/ 
300403 


RN/ 
300303 


STATUS/ 
303F21 


134 |TASK <program name> IS |ASSIGN/ The specified program [Check and re-enter the 
NOT THE SPECIFIED 303022 name does not match -feorrect mix nuaber/ 
PROGRAM | the specifted mix. program name. 

| AT/ 
300206 


EX/ 
300106 


|SEND/ 
303E22 


STATUS/ 
303F 22 
STOP/ 

304022 


1t-¥ 


Messace 


135 JTASK <mix numter> 
41S NOT CURRENTLY 
_ {RUNNING | 


(136 |=<mix numter>" 1S NOT 


[A VALID MIX NUMBER 


Table A-1 Ccont) 


Error Messace Table 


ASSOCe 


Comaand/ 


Fetch 
Value 


Reason 


A’ @ix nusber was 
entered with a command 
for a task that is 

AT/ | not running. 

300217 


ASSIGN/ 
303023 


EX/ 


300106 


MX/ _ 
300600 


SEND/ 
30 3E£23 


STATUS 
30 3F23 


STOP/ 


304023 


ASSIGN/. 
303024 


The entered mix nuater 
is larger than the 
number of valid mixes. 
AT/ ° | 

300206 


APPENDIX A (cont) 


None. 


Enter the correct mix 
number. (Verification 
can be made by entering 
STATUS MIX.) 


APPENDIX A Ccont) 


82oV¥ 


Table A-1 Ccont) 


Error. Message Table 


ASSOC. 
Command/ 


Fetch | 
Vatue , Reason | — Action 


Message 


ENQ/ 

301£05— 
or 

3G1F05 


EX/ 
300106 


GT/ 
300807 
MX/ 

| 300600 


NT/ 
300907 


PL/ 
300406 


PR/ 
300702 


|, RESTORE/ 
303224 © 


 62-¥ 


Coamman 
Fetch 


Message | Vatue 


RN/ 
300306 


SEND/ 
30 3E24 


SET/ 
301D05 


ASSOC. 


Table A-1 Ccont) 


Error Message Table 


d/ 


Reason 


STATUS/ 


303F24 


STOP/ 
304024 


|WMIs 
301C04 


1137 | PROGRAM <program name> |STOP/ 


CANNOT GE STOPPED = [304025 
NOT RUNNING - 


An attempt was made to 


stop a programa that 
was not running. 


Nonee 


APPENDIX A Ccont) 


OL-¥ 


APPENDIX A Ccont) 


139 


140 


141 


Message 


PROGRAM <program name> 
|}CANNOT BE ASSIGNED IN 
|PFACTICE MODE = NON 
IPARTICIPATING 


NQ DATA 


STATION <tlogicat 
station number>/ 
<station name> 
CANNOT USE PRACTICE 


MCDE - CONCENTRATOR 


Table A~1 (cont) 


Error Message Tabie 


ASSIGN/ 


302027 


AT/ 
30020D 


EX/ 
300100 


PL/ 
30040D 


RN/ 


4300300 


READ@- 


1MESSAGES@= 


QUEUE/ 
402F0C 


PRACTICE/ 


| 303c29 


Reason 


iThe specified station 


is currently assigned 
to a program <progran 


Iname> and is in 


practice mode. 


MCP messages queue 
was empty. 


A concentrator station 
was specified for 
practice mode. 


Action 


: Determine whether this is 


the correct station. If 
it is» take it out of 
practice aode and 
re-enter. 


Normal resuit. Not an 
error. 


Specify another station» 
if possible. 


TEV 


143 


1144 


145 


Message 


| STATION <togical 


station nuaber>/ 
<station name> CANNOT 
USE PRACTICE MODE - 


“HOST 


STATION <Logical 


istation nusber>/ 


€station name> CANNOT 
USE PRACTICE MODE - | 


LCGGED OFF 


iSTATION <logical 


station nuasber>/ 


i<station name> CANNOT 


USE PRACTICE MODE - 
ATTACHED 


STATION <tlogical 
station nuaber>/ 
<station name> 
CANNOT USE PRACTICE 
MCDE - ASSIGNED 


Table Am1 (cont) 


Error Message Tabte 


ASSOC. — 
Coamand/ 
Fetch 
Value 


PRACTICES 


1 303C2A 


PRACTICE/ 
303C28 


PRACTICE/ 
303C2C 


FPRACTICE/ 


303C2D 


Reason 


A host station was 
was specified for 
practice mode. 


A specified station 
is logged off. 


The station is 
currently attached to 


a task. 


The station is 
currently assigned to 


fa task. 


APPENDIX A Ccont) 


Action 


Specify another station» 


if possible. 


Log on at the station or 
Ispecity another station. 


Detach the station or 
specify another station. 


Refer to the DT command tn 


qsection @. 


{Detach the station or 


specify another station. 


‘Refer to the DT command in] 


section &. 


creV¥ 


MSg.- 


INOs 


146 


147 


149 


156 


APPEADIX A (cont) 


| <command> REQUIRES A 


MIX NUMBER =- MULTIPLE 
CCPIES CF <precgraa 
name> RUNNING 


CANNOT SEND TC 
PROGRAM <program naage> 
- NOT RUNNING 


CANNOT SEND TC 
PROGRAM <prograa 
name> ~ NO DUMMY 
STATICN MCS IN NOL 


LCGON DENIED - 


ACCESS MEY REJECTED 


LCGON DENIED - 
PASSWORD REJECTED 


Tatle Aw-1 Ccont) 


Error Message Table 


ASSOCe 
Coamand/ 


Fetch 
Value 


SEND/ 
30 3E2E 


STATUSS 
3Q03F2E 


STOP/ 
SG 4O02E 


SENDS | 
30 3t2F 


SEND/ 
S03E31 


 LOGON/ 


36 3A32 


LOGON/ 
303A33— 


Reason 


The mix number of the 
intended program must 
be specified because 


multiple copies of the 


program are running. 


The specified program 
is not running. 


The specified program 
1S not participating» 
and the dummy station 
MCS ts not dectared 


in NDL. 


An invalid access key 
was entered (Cnot 
defined in TCL). 


The entered password 
is not correct for 
this access key 

Cin TCL). 


Action 


Review the mix and enter | 
the mix number of the 
specified program. 


Check program name and 
Start up the programs or 
correct the name. | 


Specifiy another 
program. 


Enter correct access 
key. 


Check the access key 
and/or password. 


£L=-V 


152 


154 


155 


Message 


<disk name> EFROR-= 


DISK NAME TOO LUNG 


CANNOT ASSIGN PROGRAM 


<program name> - 
ATTACHMENT ROUTING 


CANNOT ASSIGN PROGRAM 
<program name> = — 
MAXASSIGNERS EXCEEDED 


ASSOC. 
Command/ 


Fetch 
Value 


MERGE/ 
30 3834 


ASSIGN 
350 3036 


AT/ 
300200 


EX/ | 
300100 


PL/ 


300400 


RN/ 
300300 


ASSIGNS 


303037 
AT/ 
300217 


EX/ 
300137 


Table Awr1 Ccont) 


Error Message Table 


Reason 


The specified disk 
name exceeds seven 
characterse 


a 


The specified or 
igplied stations 
exceeded the maxitaus 
atlowable nuaber of 
assigners to the pro- 
gram Cas specified in 
the TCL MAXASSIGNERS 
attribute). 


APPENDIX A Ccont) 


| Check the specified fite 


name and re-enter. 


Specify a fewer number 


of stations tn the station 


list» wait for a user to 
detach» then try agains or 
initiate a new copy of the 
program and assign to it. 


APPENDIX A Ccont) 


¥f=V 


IMsce | 
No. Message 


~—156 |FCANNOT ASSIGN PROGRAM 
<program name> - 
IMAXCOPIES EXCEEDED 


las7 |CANNOT INITIATE 
TRACE - NO STATION 
]<station name> 


158 |<file name> ERROR = 
IFILE NAME TOO LONG 


Table A-1 Ccont) 


Error Message Table 


ASSOC 
 Command/ 


Fetch 
Vatue 


ASSIGN/ 
303038 


EX/ 
300138 


PLI 


300438 


RN/ 
300338 


TRACE? 
304239 
MERGE/ 
30 3B3A 


SEND/ 
50 3E3A 


STATUS/ 
30 3F 3A 


STOP / 
3S04G3A 


Reason 


At attempt was made to [Wait for a copy of the 
initiate an additional jtask to go to End-of=Job 
copy of the specified land try again. 

program that caused the ] 

total copies of the 

program to exceed 

MAXCCPIES (the maximum 

number of copies of a 

program that can run 

concurrently as defined | 


in TCL). 
The specified station ICorrect the station 
is not declared in iname and reventer. 
1TCcl. 3 
|The specified fite Check and correct the 


name exceeds the waxi= specified file or enter 
mum permitted 12 lanother file name. 


characterse 


6 ge¥ 


161 


162, 


163 


Message 


CANNOT MERGE - 
NO FORMAT FILE 


NO RECORDS IN FILE 


INVALID CONFIGURATION 


LEVEL IN FILE 


CANNOT MERGE SOURCE 


FORMAT FILE 


MERGE FAILED - FORMAT 
FILE TOG SMALL 


Table Aw1 (cont) 


Error Message Table 


ASSOC. 
Comnand/ 

Fetch 

Vatue 


MERGE/ 


~—~505eS8 


| MERGES 


30 3B3C 


MERGE/ 
30 383D 


MERGE/ 
303B3E 


MERGES 


30 383F 


Reason 


The on-tine format 
file CMCSFMT) is not 
present. | | 


The specified file 1s 
not a vatid format 
fite. 


The file being merged 


is an invalid format 
file. 


Only object format 

files (not source 

format files) can be 
merged. 


The maximum size for 
the cn-line format 

. file has teen 
exceeded. 


APPENDIX A (cont) 


Bring down the MCS» 

enter a format fite with 
the correct name> tring 
up the MCS and re-enter. 


Correct the file name. 


None. 


None. 


None. 


Oey 


APPENDIX A Ccont) 
Table Aw1 (cont) 


frror Message Table 


Assoc. 
Comaand/ 


sg. Fetch 
NO « Message Vatue | Reason 


164 | CANNOT SEND TC SEND/ The specified program Specify another program. 


PROGRAM <program 303E4C has a TMCS interface Refer to the TO command in 
name> - TMCS INTERFACE | Cwhich is unable to section &. 
handle SEND messages). 
166 | INVALID ACCESSKEY CHANGES An attempt was made to | Correct the access key 
| 307142 change a nonwexistent and revwenter. 


access key. 


167 | INVALID PASSWCRD CHANGE/ | An invalid password Correct the password and 
: 303143 | was entered for this reventer. | 
| access key. 


168 | ACCESSKEY <accesskey> CHANGE/ The new access key Use a different access. 
- | ALREADY IN USE 303144 already exists (dupli- | key. 
_ 3 cate access keys are 
not permitted). 


170 | STATION <tsn>/<statton | TRACES The specified station Ready the station. 
nawe> CANNOT FECEIVE 304246 name 1S not ready. 
TRACE - NOT READY | 
172 | <command> DENIED = ‘| CLOSE/ The command was issued | This command may only be 
VALID FGR A REAL 303348 #$| from a task» a CC entered from areal. 
STATION ONLY | | files» or the SPO. station. 
LOGOFF 


303948 


APPENDIX A Ccont) 
Tattle A-1 (cont) 
Error Message Table 


ASSOCe 
Command/ 


Fetch 
Value | Reason Action 


LOGON 
30 3A48 
PRACTICE/ 
303C4@8 
173 |LSN <lLogical station ENG/ | The entered togicat Re-enter with correct 
number> TOO LARGE 3G1E05 station number is ftogical station number. 
or larger than the maximum 
301F05 permissible number. 
PR/ 
300703 
SET/ 
301D05. 
174 | LQN <logicatl queue ENQ/ The entered Logical Re-enter with correct 
number> TOO LARGE ~ 361£05 queue number is targer |fogicalt queue number. 
or {than the maxiauam : 
301F05 = |permissible nuaber. 


7 Sd | 


APPENDIX A Ccont) 


Qf -¥ 


Table A-1 (cont) 
Error Message Table 
ASSOC. 


Command/ 
Fetch 


Messace . Reason Action 


175 |STATION <station name> | ENG/ The station name does Correct the station or 


INVALID 301£&02 not correspond to the logical station number. 
: or logical station number 
301F02 or is not a vatid 
Station name. 
CF/ 
300A06 . 
SET/ : 
301002 
TEST/ 
301A03 
STOPTEST/ 
301903 
176 | CANNOT DETANK - DETANK/ The station cannot bce Re fer to the NY commands 
'STATICN <Uisn> <station | 30344C cetanked because it is | then rewenter the DETANK 


name> READY ready. (Only stations | command. 
| : that are not ready may | 
te detanked.) 


6£-V 


177 


180 


Message 


TASK <mix nuater> / 
<progeas name> 
IAVALIO 


CANNOT DETANK = 
STATION <Usn>/ 
<station name> TANKING 


NOACK MAY NOT BE 
SPECIFIED IN COMMAND 


Table Aw1 Ccont) 


Error Message Table 


Fetch 
Value 


| ENQ/ 


301£02 
or 


301F02 


MX / 


300600 


SETS 
301002 


DE TANKS 


30 344E 


ASSIGN/ 


30305C 


ATS 
300250 


EX/ 


300150 


PL/ 


300450 


RN 
-30035C 


Assoc. 
| Commands 


| Reason 


The entered program 


name does not asatch 
the name assigned to 
the mix nuaber . 


The destination sta- 
tion for the detank is 
tanking itself. 


The TCL progran 
attribute NOACK is 
defined Ceither by 
default or — 
explicitly) to be 


false. 


APPENDIX A Ccont). 


Correct the invalid 
program name or mix 
nuaber. : 


| DETANK to a ready station.| 


None. If NOACK must be 
specified in a command» 
NOACK must tbe changed to 


TRUE in the TCL. 


O%-¥ 


APPENDIX A Ccont) 


181 | LOGONALERTS MAY NOT 
BE SPECIFIED IN 
COMMAND 


182 | PROGRAM <prograa 
| name> HAS <integer> 


NOT <integer > 


Tatle A-il (cont) 


| Error Message Table — 


Assoc. 
Coanmand/ 


Fetch 
Value 


ASSIGN/ 
303651 


Avs 
300251 


EX/ 
300151 


PL/ 


300451 


RN/J 
300351 


ASSIGNS 


|. 303052 
TRANSACTION QUEUECS)» | ca 


ATs 
300203 


EX/ 


309103 | 


PL/ 
300403 


RN/ 


309303 


| Ceither by default or 


An <integer> 


Action 


Reason 


None. If COGONALERTS 
must be specified in a 
commands LOGONALERTS 
imust be changed to TRUE 
in the TCL. 


The TCL prograa 
section attribute 
LOGONALERTS ts defined 


explicitly) to be 
fatse. 


Check the programs then | 
specify the correct number 
of. transaction queues. 


nuaber of transaction 
queues was specified 
in a quede option that 


differs from the 
muaber df transaction 


queues defined Ceither. 


| ty default or 
~—6merxplicitlys» using the 


GUEUECOUNT attribute in 
the program section of 
TCL) for the spec ted 
program. 


Tv 


| APPENDIX A Ccont) 
Tabte A-1 (cont) 


Error Message Table 


Assoc. 
Comsgand/ 


| Fetch i | 
Message | Value 7 Reason 


Action 


183 |NO STATIONS ASSIGNS | A stash mark (/) of an| Specify a different 


JAVAILABLE , | 303053 equat sign (=) was queues or wait for a 
| | specified in a station | station to tecoe 
AT/ | options but no awatlable. | 
30020D stations are avail- 
| able on the specified — 
EX# |} or defauitt queue. 
300100 — | | 
PL 
RN/ 
300300 
Tos | 
301803 
184 |AT LEAST ONE STATION . ASSIGNZ An equat ‘sign (=) was A stash can be specified 
ALREADY ASSIGNED 303054 specified in a station | te take ali avaitabte 
; , | options but one station stations on a specified 
ATs on the speci fied or or default queue. 


30020D default queue is 
currently attached to 

EX/ a different queue. 

30010D — | - * 


cyan 


Ines 


l1e6 


APPENDIX A Ccont) 


Message 


ASSIGN DENTED - 
PROGRAM <prograr 


name> WAS INITIATED | 


VIA *RN OR *PL 


1 COMMAND 


SPECIFIED NUMBER OF 


1 QUEUES (<nuaber>) 


NOT AVAILABLE 


Table A-1 (cont) 


Error Message Table 


ASSOCe. 
Command/ 


Fetch 
Vatue 


PL/ 
300400 


RN/ 


300300 


ASSIGN/ 
303055 


ATs 
300217 


ASSIGNS 


303056. 


AT/ 


300204 


EXs 
300104 


Reason 


An attewapt was made to 
ASSIGN to a currently 
executing program 
(<program name>) which 
was Initiated by an RN 
or PL commande (COnty 
the stations speci fied 
in the inittat RN or | 
PL command may be 


| attached to a task.) 


The nuaber of queues 
specified Cor» by 


‘default» as stated in 
' TCL) for the requested 


program is currently | 
unavailable. 


None. (Do not attempt — 
to ASSIGN to that copy oF | 


| the program.) 


| Verify that the speci- 


fied number of queues its 


| correct and that enough 


queue(s) Cor NOL files). 
have been specified 


| in NDL- 


Messace 


187 |REQUESTED COPY OF 
‘MIX/PROGRAM AKD QUEUE 
|pO NOT MATCH 


300203 


Table A-1 (cont) 


7 Error Message Table 


ASSOCe 
Coamand/ 
Fetch. 
Value 


PL/ 


300404 


RNS 
300304 


 ASSIGN/ 
303057 


AT. 


EXs 
300103 | 


300403) | 


| oene 


| 300303: | 


c4eV 


A <mix nuaber> and 
<queue>/ were speci- 
fied in a command for 


amix number to which 
a queue is not 


assignede 


APPENDIX A (cont) 


Verify mix nuaber 
and <queue>/ by referring 
to the STATUS or MX 


commandse 


ic 
iE : | 
APPENDIX A (cont) | | 
Table A-1- (cont) 
Error Message Table 


Assoc. | 
Command | 


Fetch 


Message Value Reason Action 


lise [MULTIPLE TASKS | ASSIGNS | AN ASSIGN did not 1oS the unwanted copy and 


PENCOUNTERED WHEN 363958 | occur because a copy fresenter the commande 
IZIPPING PROGRAM | of the task appear ed 
i<program name> : EX/ | in the aix when GEMCOS |. 
| | 300115 was attempting to ZIP | 
j execute the requennes 
PLZ | task. | 
300415 f[- 
| RN/ 
300315 
a9 FINVALID OR MISSING | ASSIGNS [| A specified station TVerify the station list. | 
ISTATION ID 303059 | in a station List is | the request is froa 
: | not defined in NOL» or | a non-controt stations do | 
AT/ f a station list is Inet specify the station | 
300200 §| specified from anon [tast. If the request is 
2 | controt station. from a controt stations | 
- OTF os | ensure the controt station 
390505 BE logged ‘OMe 7 
EX 


300100 | 


cy-V 


APPENDIX A Ccont) 
Table Awl (cont) | | 
| Error Message Table 
Assoc. 
Coaaand/ 


Fetch — 
Vatue 


Reason | | - Betion 


Message 


300400, 


RNJ 
300300 | 


19G [QUEUE INVALID OR IN | ASSIGN/ The specified queue.is |Specify an availabie queue 
USE 3O305A currently in use and | | 
| is unavaiiabte to a 
| ATs new copy of the task. 
300203 | he 


EX? , 
309103 


| PLs 
300403 


RNS 
300303. 


191 [LIMITED TO EXCLUSIVE Cr / The resource atready Weit until the exclusive 
CONTROLLING FUNCTION 300A01 has an exctusive con cantrotling function re- | 
7. ® | trotting function. | linquishes the resource 
Cu/ | | Ez and re~enter. 3 
302IFF | 


DETANK/ 
30 34FF 


ci ee = 


APPENDIX A Ccont) 


IKRSge —— 


NO « 


Message 


1492 |LOGON DENIED - 
| UNATHORIZED USE 
|FOR ASSIGNED TASK 


Table A-1 (cont) » 


Error Message Table . 


"Assoc. 
Cogagand/ | 
' Fetch — 


Value 


NY/ 


—3015FF 


RD/ 


301002 


RES. 
3O020FF 


RLS 


RS/ 
300FFF 


RY/ 


— 3SOL4FF 


SET/ 


 301DFF 


LOGON/ 


303A5C 


Reason 


S00EFF 


Indicates an atteapt 

| file name combination 

| Station that is 

| currently assigned to 
a task for which the 
access key is tllegat. 


‘Action 


‘| Check the access key and 


re-enter of detach the 
task. Refer to the DOT 
command in section 8. 


Ly-W 


APPENDIX A Ccont) 
Table A-1 (cont) 


Error Message Tabte — 


ASsOCce | 
Coanand/ | 
| Fetch | 
| Vatue 


Action 


Message 


In the program section | 
of TCL» the list of 
vatid assigners does 
not contain the 
specified accesskey. 


194 | NO STATIONS DT/ A DETACH command was | Nene. 
| ATTACHED } 300505. entered for a speci- |. | 
: : | | fied queue that had no | 
stations attached : 


to tit. 
fies i<togicat queue | ENQs | The entered queue nage | Correct the queue nase ofr | 

; number >/ <queue nage> 301E02 does not match the | the Logicat queue nuaber. | 
F INVALID QUEVE or name assigned to the | 
1 3SO1FO2 togicalt queue nunber. 

OTs | The specified queue is | Check and correct the 

300504 not defined in NOL. queue name. 

SETZ. 


301002 


g7-V 


APPENDIX A (cont) | 
Tabte Aw1 Ccont) 


Error Message Table 


Assoc. 
Comaand/ 


Fetch | 
Vatue Reason | | Action 


196 | STATION <tsn>/ DT/ | The specified (Cor check that reat station/ 


<station name> NOT 300505 | default) reat station queue combination and 

IATTACHED TO QUEUE | is not currently verify that no dumay 

<queue name> attached to the speci~ [stations are specified in | 
| fied queuee A dummy the station list. | ; 


Station has been speci-| 
fied in the station | 
list with reat stations, 


197 |ASSIGN DENIED - | ASSIGNS | An ASSIGN comsand was |E€ater DT or CLOSE» 


CANNOT ASSIGN STATION 303061 {| entered from a station jthen re~enter the command. 
WHILE ALREADY ASSIGNED | that is currently Refer to the OT or CLOSE | 
ATS attached to a prograa commands tin section @. 


309200 which is defined 
| Ceither expticitty or 


EX/ -by default using the TCU 
30010D program section attri- | 
a | bute REASSIGNOK) to be 
PLS. Fatse. - 

J 30040D | 
RN/ 


300300 


649-V 


| APPENDIX A (cont) 
Table A-1 (cont) 


Error Message Table 


ASSOC. 
Coamand/ 


Fetch 
Value 


Reason 


100C |INVALID LLN NY/ | The togicat Line number|Correct vatue and 
7 | 301501 entered exceeds the re-enter. 
Maximum permitted value 
RY/ | (as defined in NDL). 
301401 . | 7 | 
1002 |INGT APPLICABLE ON B&O CFs a A Datacom Processor Remove the DCP 
CR B9C. . 3G0A09 (DCP) is not a valid |resource from the 
| resource on a B&O. request. 
OL | | 
301302 
RD/ : 
301003 
AQ0G3iLIMIT INVALID SET/ 4 timit outside the Enter a Limit within 
| | -3901D0C range 1 thru 127 was the 1 thru 127 range. 
; entered. . | . 
1004 ]}]UNKNOWN ACTION | ENQ/S | A non-recognized or Enter only one of the 
7 301601 | changed timit was four timits. os 
or | entered... COnly four a. . 
301F01. limits aay be entered: 
IL» OL» QL» and SL.) 
SET 
301001 


OSe¥ 


WSge - 
iNOo Message 


APPENDIX A Ccont) 


]1006 {NUMBER EXPECTED 


Table A-1 (cont) 


£rror Message Table 


ASSOC. 
Comaand/ 
Fetch 


Value Reason 


BREAKS 
30CB01 | not entered in the 
or | syntaxs or a non- | 


300802 numeric togical 


| station number > 


CFs | togicat queue nurber> _ 


30Q0A06 | wix number or timit 
was entered. 


DIs- 
301705 


DIALOUT/ 
301101 


DISCON- | 
NECT/ 
301201 


EI/ 
301705 


ENQ/ 
301E03 
or 
301F03 


A required nuaber was 


Action 


Ensure that the togical 
program nuater or the | 
logical line number are in| 
the correct positionss or 


enter a numeric logical 


station numbers» Logical 
queue nuabere mix nuaber 
or liait. | 


1Se¥ 


Message. 


— APPENDIX A Ccont) | 
Table A-1 (cont) 


Error Message Table 


‘Assoc. 
Command/ 


Fetch — 
Vatue Reason — 


Action 


NY/ 


301505 


RS/ 
300F07 


RYS 
(301405 


SET/ 


301D03 


TOs 
301001 


WMI/ 
301C01 


2Se-V¥- 


APPEADIX A (cont) 


Messace 


jioc7|s ExPecteD 


laGcel<field> TOO LARGE 


PIOLOILETTER EXPECTED 


LG11/FILE 1D EXPECTED 


Table A-1 (cont) 


€rror Messace Table 


ASSOC. 
Commands 


Fetch 
Value. 


ENQ/ 

301£04& 
-OoF . 

301F04 


SET/ 
301004 


RECALLS 


302005 


ENQ/ 


. 301607 


oF 


'301F07 


SET 
301007- 


ASSIGN/ 
30 306F 
ATS 
300106 


Reason 


A required slash (/) | 


was not found in the 


| syntax. 


| The togical queue 


numter or togical 
Station number is not 


defined in NOL. 


An incomplete command 


was entered... 


The program name or 
queue name was not 
specified with the 
command. 


Action 


Check the syntax and 
re-enter the command. 


Refer to the OL command in 
section & for correct isn | 


| or dan. 


Enter all necessary 
syntax. 


Specify a program name or | 


“queue name. 


Message 


Table Aw-1 Ccont) 


Error Message Table 


ASSOC. 
Comaand/ 


Fetch — 
Vatue 


Reason 


APPENDIX A Ccont) 


Action 


ICi3S JQUEVE REFERENCE 
INVALID © 


1017 j}INVALID STRING 


£Ga¥ 


MC SKRUN 
3C2EFF 


SETS 
301009 


ASSIGN/ 
303071 


AT/ 


360203 


ENQ/ 
301£09 
or 
301F09 


RL/ 
300E02 


A queue was specified 


that is not assigned 


to a currently 
executing task. 


An invalid queue name 
was entered. 


An invalid line type 
or mocem nua@ber was 
entered. 


Verify that the program 
1s executing on the 
specified queue assigned 
to ite | 


Enter the correct queue 
name. 


Correct the number and 


re-enter (referencing the 
RL command in appendix 8). 


APPENDIX A (cont) 


¥GeV 


Table @-1 (cont) 


Error Message Table 


ASSOC. 
Cosmand/ | 


Fetch | 
Value | Reason 


Messace Action 


1018 {ALREADY ASSIGNED CFS |. An attempt was made to | Wait until the current 
Z00A01 become a controlling controlling function 
| function of a resource |is cleared. | 
that already has a 
controtling function. 


1019 JCF INVALIO | CFs | The CF command contains Correct the syntax and 
, SQQAQ02 | a syntax error or was re-enter. 
“Issued impropertly. | 


1019 |<field> INVALID i | PR/ An invalid field was 'Correct the syntax. 


300702 | entered. : | and re-enter. 
or | = 
300703 
RSs 
—~300F05 
WHMIS 
301006 
1019 i<string> INVALID 7 CONF/ | An tnvalid string was Correct the syntax 
| 300C03 entered in a network | and reenter. 
or  { unit. | - a 


300C05. 


GGe-V¥ 


Messace 


tie2c INVALID STATICN NAME 


RS/ 


Table A-1 Ccont) 


Error Message Table 


ASSOC. 
Command/ 

Fetch 

Vatue Reason 


AP300- The station specified 
1s not defined in TCL 


STATUS/ 
303506 | to be an AP300- 


CL/ A nonexistent station 
302102 name was entered. 


EI/ 
301606 


ENQ/ 
53G90805 


GT/ 
300805 


NT/ 
300904 


NY/ 
361506 


300FOQ 3 


APPENDIX A Ccont} 


Action 


Define the station as an 
AP300 in the station 
section of TCL or perform 
STATUS only. 


Correct the station name 


and reenter. Refer to 


STATUS or the OL command 
in section & to determine | 
correct station name. 


9G-V 


1025] 
2 }ON A LINE 


APPENDIX A Ccont) 


MSgof 


No. 


1022] 


iC23] 


14024 


Message 


STATION SPECIFIED IS 


MISSING EGUAL SIGN 


ONE €1) OR ZERO (0) 


}EXPECTED 


NOT CHANGED = NOT 


Table @-1 (cont) 


Error Message Table 


Assoc. 
Comaand/ 

Fetch 

Value 


RY/ 
301406 


TEST/ 
301A01 


STOPTEST/ 
301901 


TOs 
301802 


AP300- 
STATUS/ 
303574 


RS/ 
30 0F 06. 


RS / 
SC 0FO8 


RS/ 
SQGFQA 


Reason 


‘The station specified 


is not defined tin TCL 


ito te an AP3900. 


lA required equal sign 
was not entered. 


lA required 1 or 0 was 
inot enterede 


Indicates an attempt 
Ito redefine a station 
without specifying 
ithe tine. 


Action 


Define the station as 
an AP300 tn the station 
section of TCL or 

perform STATUS only. 


Correct the syntax 
and reenter. | 


Correct the syntax 
and reenter. 


Re-enter the command 
with a logical line 
nuaber for the station. 


LG" 


iC2/ |CONF ALREADY IN 
, IPFOGRESS = REGUEST 
DENIED 


1029 [INVALID SPEED 


IC3CiINY L <tine number>. 


APPENDIX A @cont) 
Table fA-l (cont) 
Error Message Table 


ASSOC. 
Conmand/ 


Fetch ~ 
Value Reason Action 


CONF / Cnty one CONFIGURATION | Waitt until execution of 
300C05 command may be in the prior CONFIGURATION 
progress at one time. command 1s completes then 


rew~enter. 


CONF/ | | An invalid speed was Correct the speed and 


300C02 entered. lrewenter. 

RS/ 

3Q00F 08 

CONF / A network unit or other; NY the specified line 
300C05 command was entered and reenter the specified 


within a CONFIGURATION | CONFIGURATION command. 
commands but the lines 
were ready. 


APPENDIX A Ccont) 


BG-¥ 


Table Aw1 Ccont) 


Error Message Table 


ASSOC. 
| Command/ 
' Fetch 
Value 


Message Reason - : Action 


F103 ERROR - LINES READY | CONF/S #=| Network units and other|NY the specified list | 
ft a | 300C05 | commands within | jof lines and rewenter the | 
| the CONFIGURATION com=- | CONFIGURATION command. 
mand may not be entered} 
unless att lines are | 
in notrready status. 
(The CONFIGURATION 
command ts exited as a 
result of the error.) 


L103Z/TASK NOT ATTACHED } BREAKS This task is not i The task should be pro- 
& | 300801 | attached to the task igrammed not to send a 
|. to which the break is | break to an unattached 
teing sente | task. | 
f40331/SP0 NOT ATTACHED | BREAKS | The SPO 18 not Use a station which ts 
| 7 300B02 attached to the task | attached to the task» or 
to which the BREAK is attach the SPO to the 
being sent. task. Refer to the 


ASSIGN or EX command 
in sectton &. 


6G-¥ 


IMsge| 
[Nos | Message 


W1034|<disk-I0>/<file-name> 


INOT AVAILABLE 


1035|<field> <fietc> 


i INVALID 


1036/01 DENIED = NO STATION 


}AVATLABLE 


11037|<field> <fiela> 


rEXPECTEDO 


110381 <field> <fiela> 


[NOT APPLICABLE 


}1039/COLGG OPTION NOT SET 


| ccs 


1 DT 


Table A-1 Ccont) 


Error Message Table 


| ASSOC. 
| Command/ 


Fetch 
Value 


3O02A06 


| RECALLS 


362002 


300565 


| RECALL 
| 302003 


| RECALL/ 
| 302606 


ics 
1 302404 


Reason 


A non-existent or 
unuseabte disksID and 
file name combination 
Was specified. 


An entered field is 
invalid. 


This confirms that 
the command was 
Syntactically correct 
tut no stations were 
avattatble for 
detach@ent. 


A required field was 
not entered. 


An unrelated fietd was | 


entered tn syntax. 


The Control tog is not 


open. 


APPENDIX A Ccont) 


Action 


SESE LES MRS TAN LS aM TE te SOS Es Gg thee oe fl 


Verify that the disk-ID 
and fite are onetlines and | 
that the file is 
sequential. 


! Correct syntax and 
| re-enter. 


i None. 


| Note syntax and enter 
| required field. 


Correct syntax and 


|} rewenter. 


i Set the COLOG option 

i by entering the SO 

i commands then rerenter 
| the LC command. 

| the SU command in 


Refer toy] 


section &. 


09-V 


APPENDIX A contd 


Message 


HO39|ERLOG OPTION NOT SET 
HO39|EVLOG OPTION NOT SET 


O4C|EVENT LOG NOT OPEN 


Tatte A-1 Ccont) 


Error Message Tabte 


ASSOC « 


| Commands | 


Fetch 
Vatue 


1 ic/ 
| 302493 


; LCs 
| 302402 


1 GT/ 
| 300804 


Reason 
The Error tog is not 


OpeNne — 


The Event tog is not 
open. 


Indicates the Event 
log is not avaitabte. 


Action 


Set the ERLOG option 

by entering the 50 
commands then reenter : 
LE command. Refer to the | 
56 command in section &@. 


Set the EVLOG option | 
by entering the SO command 
Refer to the 59 command ini 
section 8. Then re-enter | 
LE command. 


Enter SO EVLOS to enabie 
the Event log. Enter GT 
com@and again or send the | 
trace to the tine printer.] 
Réfer to the 30 command inj 
sgction 8. 


1041 1ASSIGN CENIED = NO 
| DUMMY STATIONS €X<n>) 
AVAILABLE 


1042 )/ASSIGN DENIED - 
REQUESTED QUEUE 
(<queue name>) 


ASSIGNED TO A 
[DIFFERENT TASK 


T 9 


Table A-~1 Ccont) 


Error Message Table 


ASSOC. 
Command/ 


Fetch 
Value 


ASSIGN 
393680 


EX/ 
3090104 


RN/ 
300304 


PL/ 


| 300404 


ASSIGN/ 
30 308E 


AT/ 
306203 


EX/ 
300103 


Reason 


There are no dummy 
stations availatle. 
(A dummy station in 
the form MX <itinteger> 
must be declared in 
NDL for each program 


finitiated by GENCOS.) 


The requested queue 
(queue name) is not 
assigned to the speci- 
fied task. . 


APPENDIX A Ccont) 


Action 


Determine tf enough 


| MX <integer> dummy sta- 


tions are deciared 


in NOL | 
to initiate atl the 


| programs. 


| Check the task and the 


queue(s) assigned to itt. 


| Refer to the OL or MX 


command in section @. 


APPENDIX A Ccont) 


2964 


Table Aw-1 (cont) 


Error Message Table 


ASSOC. 
Command/ 
; Fetch 
Message | Vatue Action 
~=41043)MIX NUMBER MAY NOT | PL/ A mix number was speci-|Do not specify a mix 
|@E SPECIFIED 300417 fied with the PL or RN [number with a PL or RN 
: : | command. (CExecuting jcommand. 
RN/ the PL or RN command 
300317 Causes an attachment | 
| to a newly inttitiated 
task). 
BREAK/ The BREAK command was {Reenter without the 
300893 issued from a non- imix number» or if the 
| controtlor with a mix [mix numter is required 
specified. irerwenter from a Control 
Station. 
1044] PL DENIED - STATION PL/ The specified or Ensure stations are DDE 
<station name> 30040D | impttied station tist iterminals. 
11S NOT A ODE (B9347) contains a station 


i TERMINAL which is not defined 
| | as a DDE terminat. 
The station name aust 
be prefixed by B93 and 
have tts own NDL 
“request set. 


£9-¥ 


Message 


1IC4GEPROGRAM <program name>] 


fIS NOTRUNNING WITH 
i<integer> TRANSACTION 
(| QUEUES 


LOSC|"NEW™ MAY NOT BE 


SPECIFIED FOR AT 
COMMAND 


f1051] TEXT OR PATTERN 


| NUMBER REQUIRED 


11052] INVALID PATTERN 


| NUMBER» RANGE IS. 
}1 TO 4. 


Table A=1. Ccont) 


frror Message Table 


ASSOC. 


Commands | 


Fetch 
Value 


ASSIGN/ 
303095 


AT/ 
300203 


AT/ 


300293 


TEST/ 
SC1AZ1 


TESTS 


; 301A21 


Reason 


More than one copy of 
the specified program 


is currently runnings | 


tut no copy 1s avail- 
able with the 
designated <integer> 
transaction queues 
assigned to it. 


The NEW option was 
specified for the AT 
command. (CThe AT 
command never 
initiates a new copy> 
it only attaches the 
user to an existing 


A text mesSage or 
pattern number was 
not specified. 


An incorrect pattern 
number was specified. 


APPENDIX A (cont) 


Action 


Re-enter with the correct 
numter of transaction 
queues for progras 
<program*name>. 


Enter the AT command 
specifying the NEW option. 


Specify text or pattern 
number and ren~wenter. 


Specify a correct 
pattern number and 
re-enter. 


79m 


APPENDIX A Ccont) 


Message 


/STATION <station-name 


jname> IS ATTACHED OR 
|BEING TESTED AND 
;CANNOT EE TESTED 


11054] 


1056) 
| |ARE UNAVAILABLE FOR 


BURST NUMBER 


STATICNS REQUESTEC 


| TESTING 


11057] 


QUEUE <queue rame> IS 


A COMMUNICATE QUEUE 


/ AND MAY NOT BE 


ATTACHED 


Table Awl Ccont) 


frror Message Table 


ASSOC.» 


Command/ | 


Fetch 
Value 


TEST/ 
301A03 


| TEST/ 


301A01 


TEST/ 
301A03 


ASSIGN/ 
303090 - 


ATS 


300203 


Reason 


Station specified is 
already being tested 
or ts attached to an 
application program. 


An integer 1s required.| 
;BURST Cin the syntax). 


Station list speci fied 
indicates that an 
ittlegal station was 
specified or that all 
stations requested are 
attached or teing 
tested already. 


An attempt was made to 
attach a communicate 
queuee (Only transac 
tion queues may be 
attached.) 


Action 


| Close or detach the 
istation from the 

| application program 
l|and rewenter the 

| commande. 


Specify an integer after 


| Speci fy a Legal statione a 


station that is not attach 


lor a station not already 
ibeing tested. 


| Attach a transaction 
| queue ep 
communicate queue. 


not a 


Tatle A-1 (cont) 


Error Message Table 


ASSOC. 
Command/ 
Fetch 
Value | Reason 


APPENDIX A Ccont) 


Action 


ICSEPFILLEGAL USE OF 
RESERVED COMMAND 


G9-V 


EX/ 
309103 


Pi/ 
300403 


RNS 


369303 


MCSLOG- Only SPIM may use 

OFF / this command and it 

3020F F must te togged on 
using MCSLOGON. 

MCSLOGON/ 

3G2CFF 


MCSRUN/ 


 SO2EFF 


RE AD- 
MESSAGES™| 
QUEUE/ 
302FFF 


None. Do not use this 
command. 


99 


APPENDIX A (cont) 


| 05 9| STATION <lLogical 


istation number>/ 
i<station=name> 15 
(RESERVED AND CANNOT 
i BE ATTACHED 


A4C6CG| PRIORITY CLASS 


INVALID 


Table A-1 -Ccont) 


Error Message Table 


ASSOC. 
-Command/| 


Fetch 
Vatue 


ASSIGN/ | 


390 309F 
ATs 
300200 
EX/ 
3060100 


PL/- 
30040D 


RN/ 
300300 


PR/ 
300704 


Action 


A dummy station (DC» | Femove the dummy station 
MX <integer>» CC or | from the station list. 


SPO) was specified in 


a station List where | 
only real stations are | 
valid. 


The priority class must] Re-enter using the correct 
be etther As Bs» C or | priority class. 
CD for a station» or Ap 


Bor C for a program. 


APPENDIX A Ccont) 
Table Aw-i (cont) 


Error Message Tattle 


Reason | | Action 


1CG1IJ ILLEGAL REQUEST | ZIP/ MCP intrinsics C€Ce.ge» | Use the RUN command. 
301801 MX» DS» AX) may not ce | | 
| | zipped. | 
HOGZ| INVALID OR MISSING | conte | 
TEXT | | 300CDE 
| MCSRUN The 6 BYTE header is | MCSFUN must have a minimual 
302EFF- incomplete. i text of the 6-byte header. 
PR/ The PR command is | | Re-enter using the correct] 
300701 incomplete. | syntax. | 
ZIPs The ZIP command was Re-enter using the correct] 
301802 — entered with no text. | syntax. 
iCE3Z|CC DENIED - NO CC | CC/ | The CC dummy station | Declare dummy station CC 
ICUMMYSTATION CECLARED 3SO2AFF 1s not declared in NDL.j| in NDL and recompite the 
‘IN NDL | | | NDL. 


L9-V 


a9~V 


APPEADIX A Ccont) 


lé¥sge] 
INGOs. | 


} 1066 


Messace 


IPREVIOUS CC 
ICUTSTANDING ON. 
i<disk-IC> NOT <disk«It> 


ICCMMAND NOT FOLLOWED 


BY SEMI-CCLON IN <file 


name> 


INVALID MCS OPTION 


Table Aw-1 (cont) 


frror. Message Table 


ASSOC. 


|Command/ 


Fetch 
Vatue 


lccs 
1 302A07 


iCC/ 
1 3G2A01 


;ROZ 


302701 


SETS 
301001 


S07 


392601 


Reason 


A cC output file 1s 
currently open on a 
different disk-ID. 


The command was not 
terminated by a 
semicolon. 


The first entered 
option number was too 
large. 7 


Action 


Transfer the CC input 
file to the same disk as 
the open CC output file. 


Fnsure that each 
command ends with a 
semicolon. 


Correct the option number 
and rementer. The only 
valid entries are 1» 3» 4» 
5» 6» and 7. 


APPENDIX A Ccont) 
Tabte A-1 (cont) 
Error Message Table 
ASSOC. 


Command/ | 
Fetch | 


Message 


LCé6é7]}INVALID LOG TYPE 


iCG&T RANGE INVALID 


1C6S} INVALID LSN 


69=-¥ 


Vatue 


LC/ 
3G 2401 
LL/ 
392301 


LL/ 
392302 


TEST 
301401 


CL/ 


3G 2106 


CUNF/ 
300CCS 


Di/ 


(301705 


EI/ 
391705 


GT/ 
300802 


Reason 


A misspelled or non 


existent log name was 


entered. 


The requested list of 


records exceeds the 
file size. 


WRAP or BURST number 
requested was less 


than 1. 


A nonwmexistent Cor 
non=numeric) logical 
station number was 
entered. 


Examine the syntaxe 
correct the spelling and 
re-enter. 


Determine the file size 
or omit it from the 
command. 


Check syntax» reenter 
correct WRAP or BURST 
numcer o 


Correct and reenter the 
logical station number. 


APPENDIX A Ccont) 
Table A-1 Ccont) 


Error Message Table 


ASSOC. 

Comamand/ 
Fetch 

Value 


Reason | Action 


NT/ 
300902 
NY/ 
301501 


RS/ 
300F02 


RY/ 
301401 


WMI/ 
301C02 


i¢g7G/INVALID L@N CL/ A nonexistent Cor | | Correct and rewenter the 
| 302101 non=numeric) togical logical queue numter. 
queue number was | Refer to the OL command inj 
GT/ entered (not defined section 8. 
300803 | in NCL). 


NT/ 
300903 


WMI/ 
301C€0 3 


“CL. 


| APPENDIX A (cont) 

Table Aw1 (cont) — 

Error Message fable 
ASSOC. 


| Command/ 
Fetch | 


Message Vaiue | Reason Action 


i072 | INVALID PROGRAM NAME . GT7/ | The entered prograa Verify the task is | 
| | 300806 {| name 1s misspelted or {| running Center STATUS MIX) 
3 f is not in the mix. |= {| CA nonerunning task can= | 


: not be traced.) 


11076 INUMBER OF TRANSACTION | ASSIGNS | More than three trans=| Specify only 1» 2+ or 3 
| QUEUES CAN ONLY BE 1 303083 | action queues were ; transaction queues. 
fi» 2» or § i specified. sg 


LATS 
1 300203 
EX/ 
1 300103 


PLS 
1 300403 


IRN/ 
| 309303 


ClTY 


APPENDIX A (Ccont) 


Message 


hO77— CANNOT INITIATE 

i<program name>; 
FPROGFAM ITS NOT DEFINED | 
FTG BE EXECUTED ON : 
LOE MAND 


Table A=1 (cont) 


Error .Message Tabie 


ASSOC. 
Commands | 


Fetch 
Vaiue 


ASSIGN/ 
303084 


AT/ 
300284 


EX/ 
300i1B4 


PL/ 
3004B4 


| RNZ 


HO7EFINVALID SITE NAME 


3003B4 


DIALIN/ 
301101 


DIALOUTS | 


361101 


| DISCON- 


NECT/ 


} 301201 | 


|1G79 |DISCONNECT PENDING 


| DIALOUT/ | 


3G1101 


The RN command or the 
NEW option was spect- 
fied» requesting 
GEMCOS to 
program. (Programs 
descrited in TCL as 
not to be executed on 
demand can onty be 
initiated manually» 
not thru GEMCOS.) 


The site name is 
Longer than 12 
characterse 


A previous disconnect 
request is not yet 
complete. 


i Manualty 
| gram or modify the TCL : 
idescription to be executed} 


initiate the | on demand. 


Action 


initiate the pro-| 


|Re-enter using correct 


site name. 


iWait until the controtling 
|! function of the tine Cor | 
ithe monitor stations) 

lreport that the tine has 


EL-Vv 


APPENDIX A cont) 
Table A-1 (Ccont) 


Error Message Table 


Assoc. | 
Command/ 


Fetch 
Messace : Value 


Action 


ibeen disconnected and then 


jretry. 
11 G8C| LINE DIALEO IN | DIALOUT/ |] The tine has already iWait until the line 1s 
| 301103 | keen connected Ly a | free or use another tine 
manuat diai. : 
}1061/ LINE BUSY | DIALIN/ | Cannot te reconfigured | Wait until line is free. 
| | | 2011€1 line is tn uSe. 
DIALOUT/ | Line already diated | Wait until Line is free or | 
301102 out to another site. fuse another tine. | 
110@2; PEONE NUMBER NAOT IN | DIALINS | The phone number was | If number was wronge 
| DIRECTORY 301101 i not found in the phone | rementer with correct 
| directory file. number» otherwise use RS | 
i command to manually recone | 
| figure the line. Add this jf 
[ site to the directory at 
i the next opportunity. 
DIALOUT/§| Ba number was wronge 
361101 | | | reventer with correct 


fnumcers otherwise» use RS | 
| command to manuatly recon-|{ 
| figure the line and then 

| dial again. Add this site] 
i the directory at the next | 
| opportunity. ~ 


7L-V 


APPENDIX A Ccont) 


Message 


11083] DIRECTORY FILE <fite 


| name> NOT AVAILABLE 


Table A-1 Ccont) 


frror Message Table 


ASSOC. 


2 Comeand/ | 


Fetch : 
Value _ Reason 


| prscon- 
| NECTZ 
| 301201 


| DIALINS | This fite is not 
| 301101 jpresent on the TCL 


; designated disk. 


DIALOUT/S | This fite is not pre- 
301101 sent on the TCL 
| idesignated disk. 


| DISCON]- 


NECT/ 
30201 


Action 


’€ the nusber was wrong» 
re-enter with correct 
numbers otherwise discon- 
n@éct the line automaticatt| 
phone number » 7 


Copy this file to the disk} 
im question and rewenters | 
or restart the MCS so that] 
anew file may be created.| 
The RS command can also be} 
used to manually recon= 
figure the tine. 


Copy this fite to the disk) 
in question and re~enters | 
or restart the MCS so that] 
anew file may be created.] 
It is aiso possibile to re} 
configure the line | 
manuatly using the RS 
command and then diat 
automatically using 
number option. 


Use the Line nuaber option} 
and disconnect automat- 3 
fioaliy. 


GL£-V 


APPENDIX A Ccont) 


Taklte Aw1 Ccont) 


Error Message Table 


ASSOC. 
Command/ 


“SG eo | | Fetch , 
Nos | Message Value Reason | Action 


CONF / 7 | Nene = The MCS will revert] 


30009 i to tne "NEW DIRECTORY™ 


or 3Q00COA | | mode and expect new 
: directories to be turlt. 


ic@4}OENTED - LINE IN | DIALOUT/ | An attempt was made to | Dial again using the site 
| |} DIRECTORY i 3S5011G1 dialout automatically name or phone numter from 
| : on a tine which 1s not | the directory. 
in the directory and 
not configured. 


1C&S| PHONE NUMBER | | DIALOUT/ | The syntax requires a Reenter with the phone 
) EXPECTED 361101 chone number to be numier .« 
| entered. 
11C&6| INVALID PHONE NUMBER | CONF/ The number contained Rerenter with the correct 
| 300CO0C one or more non-numeric; phone number. 


characters» or its 
DIALOUT/S | Length was greater 
301102 than 15 digits. 


DISCON- 
NECG/ 
5301201. 


}1087| <site-name> | DISCON= This stte 1s not cons Re-enter using correct 
| NCT CONNECTED NECT/ figured on any line name or disconnect the | 
| 301262 | fine automaticatly cy tine 
number » | 


gl-V 


APPENDIX A Ccont) 
Table A-i (cont) 
Error Message Table 


ASSOC. 
Command/ 


| Fetch . 
Messace Vatue Reason Action 


idee; LINE <logical tine | DISCON- This tine is not cur |None required. 
number> NOT CCNNECTED NECT/ rently connected. : 
| 301202 
LO9L| SITE DIRECTORY CONF / The site directory iDS the MCS» remove alt 
CONTAINS ERRORS 300CO9 file is corrupted and directory files and 
must be recreated. restart the MCS with 


DC CONF. Rerwenter the 
directory remote S1te@Se 


‘|1c11 INCONSISTENT LINE © CONF / Different tine speeds Re-enter» specifying 
SPEED |} 300C02 have teen entered for |correct line speed 
| | the same line. explicitly. 
11102| <site name> CONF/ This site name was not | None = Atready absent © 
| NGT DELETED ~ NOT ZQ0O0COE | found in the directory.]| Cunloess site name was 
: FOUND , | l wrongs in which case re- 
enter using correct site 
name). | 
| SITE NAME NOT IN | DIALIN/ | This site name was not | If name was wrongs re- 


| DIRECTORY | 301101 | found in the directory.}| enter with correct name» 
| | | otherwise» use the RS 
| command to manually recon- 
| figure the tine. Add this 
i; site to the directory at 
ithe next opportunitye : 


T00-96L90TT NOd 
AQ 18-PI-¢ Postaoy 


LL=V 


APPENDIX A Ccont) 
Tatle A-1 (cont) 
Error Message Table 


ASSOC. 
Comnand/ 


Fetch 


Message Value Reason 


Action 


DIALOUTS If name was wrong» res 

3uL101 enter with Corre@ct Name, 
otherwiser use the #5 
command to manuaittly recon 
figure the tine and then 
dial automatically» using 
the Line number and phone 
number. add this site to 
the directory at the next | 
opportunity. 


LIS4|TSTATION 3 15 NOT | ASSIGN Station specified is 
AVATLABLE 3033CC not avaitatle. | 


EX 
— 30N1CC 


AT 
3052CC 


RN 
300JCC 


ri 
$004CTC 


gl-V 


119514 15 NOT A DATACOM 


APPENDIX A Ccont) 


Table Aw-1i Ccont) 


Error Message Table 


Message Action 


Execution of a non 
datacom program from a 
station is illegal. 


Execute the program 
from the SPO. 


39 39CD 
EX 
30041CD | 


| PROGRAM 


AT 
3002CD 


RN 
3093CD 


PL 
3G6Q4CD 


APPENDIX B 


VALID RESPONSES 


GENERAL.» | | 
Network Control Commands generate externat and internat responses 
indicating a command was successfully issued. Refer to section 5» 
INTERNAL AND EXTERNAL. FORMAT. Following are exaaples of internat and 
external formats. 


Examples: 


external format: 


sae eee -~--FROM MCS: LL OK 


internal format: 


S=2>s @00Xx00@--------- LL OK > 


external response to a program: 
~ ===-@00XX00@---FROM MCS: LL OK | 


Appendix 8 provides a valid response for each command. The responses» 
with the exception of the OL and MX commard responses» are documented 
condensing the above four formats as follows: 


Example: 
2 
Pen penne me Gc dee Te “FROM MCS: w------------LL OK 
a + E . + 
a + + » 2a 
1 +-@00000@-+ 3+---------- ---~--~~ ‘ 


1 Response if requested from a program. 
| 2 Response if external foraat requested. 


3 Response if internal format requested. 


APPENDIX B (cont) 


Certain commends aiso generate a delayed response in addition to the 
response indicating a command was successfully issued. Fotlowing is an 
example of a delayed response from GEMCOS. 


7 4. 
Sa <50 byte header>S-----<12-byte station-name>----- 
—------- FROM MCS: --------------~---~--LINE 0 READY (214) --- 
+ + 
+ 7 + 
6 +-@00@<35-byte NDL header>-+ 


ee cae ee eee coe ee ee awe soem cee <P wee EE RO ae ee wee ae ee 


4 This response (<50-byte header>) is onty provided for GEMCOS tnterface 
programs» not for TMCS programs. : 


5 Indicates external format was requested. 


6 Indicates internal format was requested. 


B<2 


APPENDIX B Ccont) 


APZOOSTATUS COMMAND 


oer een nme oe nme= FROM MCS: <lsn>/<station name> <status>----- 


+ | + + | + 
+ + + | + 
+-@003500G=-+ tennnnnnnn ~<4-byte status>---<<n--n nen mn nwo nn} 


ASSIGN AND EX COMMANDS 


em mn enna ann ------FROM MCS: ----- <mix>/<program-name><queue-name> OK (126) 
+ + + | a ores rr ee ee ae 
+ + + +. 
8 +-@00XX00-@+ 9 t-------------- + 
AT COMMAND 
Senne ssScSeeee oS esos ~FROM MCS: ----~ <mix>/<program-name><queue-name> . :0K ea 
+ + + 
+ + + + 
+-@000200@-+ Poa Seea See Ses = + 
BREAK COMMAND 
Toe e nnn mmm mmm mm PROM MCS: -- BREAK OK (126) ---------- 
+ + + + 
+ + $+ + 
+-@000B00@-+ $a neem --- + 
CC COMMAND 
wenn ------ FROM MCS: ----- CC OK (126) ----------- 
+ + + + | 
+ + + 
+-@002A00@-+ 9 t-------------- + 


CES BERS ES KR MOE aD ED ame Oh Si AG eS a ED Gite ip aa aR aac 


? SYMBOLIC SOURCE fietd (DC.ORIGIN) ts equal to the dumay station (Xn) 
to the intttated prograa. 


8 XX = 01 iaplied EX» 02. explicit EX and 30 ASSIGN. B-3 


APPENDIX B Ccont) 


CF COMMAND 
iatadaiaaateatetetatetatetatateteter FROM MCS: ----- CF OK (126)----- 
+ + + + 
ot a aS + 
 +-@000A00@-+ +-------------- + 


Delayed responses: . 


Station notification 


- | $0 | sd 
+ + 


+-@00@<35-byte message header>-+ 


| oo----STATION <lsn>/<station-name> READY (212) ------- 
+ 


<3 | a . ee | - 
_ #+-STATION <lsn>/<station-name> NOT READY (215)--+ 


line notification 


---<¢12-byte blanks>----- FROM. MCS?) #=sS=SsSe<sesS<-== > ... 
. | + | + | 
+ | + 
+-e@00@<35-byte message header>-+ 


( eeese----LINE <lln> READY (214) --------- 


+ . 7 
_+-LINE <1lln> NOT READY (216) ---+ 


APPENDIX 8B Ccont) 


attach/detach notification 


----<12-byte station-name>----- BROM, MCS: Ss eases eee = > 
+ + 
+. + 
+-@Q00@<35-byte message headerm+ 


eee <mix>/<program-nameS<queue-name> OK (126) 
+ 7 , 

# . : 
_+-<isn>/<station-name> DETACHED (193) ----------- 


Where pertinent message header fields are assigned by the MCS as 
follows: 


MSGeTYPE 


= 76 Cattach) or 77 (detach) 
MSGeTASK = €M1Xx> 
MSG.SUBNETQ = ¢€lqn> 
MSG.eSTATION = <isn> 


APPENDIX 8 Ccont) 


CHANGE COMMAND 


wa--------=--------- FROM MCS: -----CHANGE OK (126)--- 


~---- CLEAR OK (126)--- 


---CLOSE OK (126)--- 


+ + + ae 
+ + + + 
+-Q00311AQ@-+ 9 terme nnn - === + 
CLEAR COMMAND 
w+ --------------- FROM MCS: 
+ + + + 
+ + + + 
+-@002104@-+ +-------------- + 
CLOSE COMMANE 
| weet -------------FROM MCS: --- 
+ a + 
+ + + + 
+-@003300@-+ 9 tenn n nnn --- + 


Feal station that tecomes closed receives: 


— ae ee Gh aap Gn ae cam me em ee 


FROM MCS: -----<lsn>/<station-name> DETACHED 


(193) >"> 


APPENDIX 8 (cont) 


CONF CORMAND 


am wone----------FROM MCS: -----CONF LISTED--- 


+ + + + 
+ + + "+ 
+-G@O00CO0@—+ 9 +---~~--------- + 


Then the following message is sent: 


ween nn -------FROM MCS: ----- ENTER DC HARDWARE CONFIGURATION----- 
+ + + + 
+ + + + 
+-@000C00@-+ +------------- + 


After END is entered the following message is sent: 
sieiaiedeinatatatatetetatenetanaanaanate FROM MCS: ----- START DIRECTORY BUILDER? (Y¥ OR N) 
+ + + + 


4-@000C00G=+ tenn nn nnn ene ney 


If Y is entered» the following message is sent: 


ere ete eee eee FROM MCS: --===BUILD NEW DIRECTORY? (Y OR N) 
+ + + + . 
+ + + | + 


+=@000C00@-@ +---~-----~~-----=+ 


Then the following message 15 sents 


mat een ae wean emeeee——FROM MCS: ------ENTER REMOTE SITES 
+ + + + 
+ + + | + 
+-@000CO0G=+ +ennnnm ataahteeteerataaanete + 


Site description may then be entered. The fotlowitng wessage 
a successful entry. | 


eee nnn ne ene FROM MCS: <-----OK 
+ + + + 
+ + + + 
+=@000C00G=+ 9 tenn nn nnn nnn nnn + 


indicates 


DETANK COMMAND 


APPENDIX B €cont) 


| peewee eee een eee FROM MCS: -=--- DT OK (126)---- 
+ + + + 
+ + + + 
+-@000500@-+ +------ a lealelante tent ete + 
DI COMMAND 
SS oa ee Oe et eo ROM MCS: ==<--OK (126) =---- 
+ , + + - + on (126) 
+ bt + + 
+-@001700@-+ taen nnn n ene + 
Detayed response: 
-----FROM MCS: --<-----------------STATION <LSN>/<station name> DISABLED--- (224) ---- 
+ + 
+ | + 


+~@00@<35-byte NDI header>-+ 
DIALIN COMMAND 


-----DIALIN OK (126)----- 


+ + + + 

+ + + + 

+=@001100@=+ +---n---- ~~~ == + 

CIALOUT COMMAND 
wa ne ne = FROM MCS? -<9= DIALOUT OK (126) ----- 

+ , + + + 

+ + + + 

+=-@001100@=+ 9 +---- ee -== + 

Detayed response: 

<12=byte station name> =o ao = FROM MCS: Sie ss i sw haa ss ce dp ci i eh Os in Gb Gove ed eas ce 

+ + 
+ + 


+-@00@<35=byte message header>---+ 


APPENDIX B Ccont) 


DISCONNECT COMMAND 


wenn nnn nnn nn nna--==FROM MCS: <-=---DISConnect OK (126) ----- 


+ + + + 
+ + + | + 


+=@001200G=+ 9 +eennn nn nn nen n nn + 


Delayed responses» if the tine ts tin the site directory and was 
connected then: | 


---<l2-byte station name>----- FROM MCS: 0 ---e------ === === =~ 


+-@00@<35=<byte message header>+ 


eo site name ON LINE <lln> HAS BEEN DISCONNECTED----- 


otherwise the response is as follows: 


~--<12-byte station name>-----FROM MCS:  --------------------------- 
| + + 
+ + 


+-@00@ <35-byte message header>-+ 


~----- LINE<11n> NOT READY----~-------------~~~_ 
DT COMMAND 
~--~--------------- FROM MCS: -----DT OK (126)--- 
+ + + + 
+ + + + 
+-@000500@-+ +-------------- + 


—B<8A . 


APPZ NDIX 8B (cont ) 


Reat station that becomes detached receives: 


mee FROM MCS: <l1sn>/<station name>---DETACHED (193)--- 


B=-8B 


APPENDIX B (cont) 


DUMP COMMAND 


----------------------FROM MCS: -----DUMP IN PROGRESS--PLEASE WAIT (171) ---- 
+ +- + + ta? ee i wt | 
+ + + + 
+-@003647@-+ +--------------- + 
eee enn - +--+ == ----FROM MCS: ----- DUMP OK (126) --- 
+ + + + | 
+ + + + 
++Q@00361AQ@-+  +----~----------- + 
EI COMMAND 
pica ie wawnnan===FROM MCS: s-===-EI OK (126) -e-===-- 
+ + + | + | 
+ + + + 


Delayed response: 


oe MCS: wee me mm me woeeereo----STATION <LSN/station name> ENABLED -~(123)-- 
‘ | 
+ + 


+~@00@<35-byte NDL header>+ 


B=8C 


APP: NDIX B Ccont) 


ENQ COMMAND 


~+---~--~--~--------F ROM MCS: _-~---STATION <1sn>/<station-name>--IL--=-<intege=>--— c 


+ + + + + + a + 
+ + + + + t-ICHt+ teen --——— + 

+-@001X00@-+ +------------- + + + 

+ | | + 

+--TASK<mix>/< program-name>----QL--+ 

+ + + 

+ +-OC-+ 

(X = E or F) + + 

+ + 

+--QUEUE <1qn>/<queue- fiame>--QL----+ 

+ + + 

+ $——= OC—+ 

+ + 

+ | + 

+--STATION <lsn>/<station-name>~--SL+ 

+ + + 

+ | | +~SC-+ 

+ | a 7 


- ¢==MCS TASK----------- ---------- Mc-+ 


tthe) Caante einth RENN ARNE ET GEES TD AD GE AE AD EID AS END: ED Ole MD etn 


9 (*) = 1c/10 currently return an (#) in place of <integer> pending a 
change in certain dat acoa communicates. 


B=-8D 


+@002300- 


GT COMMAND 
~------------------ FROM MCS: ----- GT OK (126)----- 
+ + + + 
+ + + + 
+-@000800@-+ +-------------- + 
HALT COMMAND 
(eoe--------------- FROM MCS: ----- HALT OK (126)----- 
+ + + | + 
+ | + +. , + 
—-$-@003800@-+ too an - =a === + 
LC. COMMAND 
(peewee nna -------- FROM MCS: -- (126) ---=- 
+ | + + | | 
» a a | . 
- #-@002400@-+ 9 +-------------- , 
LL COMMAND 
~---------- pane an---- FROM MCS: -----LL OK (126) 
+ + + 
+ + + 
+ $e ------------------ + 


APPENDIX B (cont) 
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APPENDIX B Ccont) 


LO COMMAND 


~---------------+------ FROM MCS: RUNTIME OPTIONS: --------~------ 
| + + 
+ + ( 
+-@002800-+ 
+ + + + + + + + + + 
+ + + + + + + + + + 


+-COLOG-+ +-ALLOW-+ +-ECHO-+ 


LOGOFF COMMAND 


+ + + + 
+ + + + 
+-@00391A@-+ +----~------—--~-~- + 


LOGON COMMAND 


a a FROM MCS: -----LOGON OK (126)------------ 
+ + + : + 
+ + + - + 
+-@OO3A 1A@—+ 9 +--~---------- == + 


42 7 Fy 


APPENDIX B (cont) 


LT COMMAND 
~---- W--------------FROM MCS: --~--LT IN PROGRESS-PLEASE WAIT (171) ----> 
+ a ‘+ | | 
+ | + + + 
+-@002547@-+ 9 te-------- mamma t 
~~~+--------------- FROM MCS: ----- LT OK (126) ----- 
+ + + + : 
+ + + + 
+~Q@00251AG@~+ 9 treme nner nnn + 
MCSLOGOFF COMMANC 
~-------------------FROM MCS: ----- MCSLOGOFF OK (126)----- 
+ + + | + | | 
+ + + + 
_+-@002D00@-+ 9 +---------=------ + 
MCSLOGON COMMAND 
--------------- ----FROM MCS: -=---MCSLOGON OK (126)-----. 
+ a : + 
+ + + + 
+-@002C00@-+ +-------------- + 
MCSRUN COMMAND 
ween nnn FROM MCS: -----MCSRUN OK (126) ----- 
+ a + | 
+ + + + 
+-@002E00@-+ +----------- —=+ 


APPENDIX 8 (cont) 


MERGE COMMAND 
The response consists of one message groups containing nore than one 
message. Cnty the last message has ENDKEY=3- the others have ENKDEY=2. 


aes FROM MCS: -----FORMAT <FORMAT> NOT FOUND (169) --- 
+ + +. 
10 + + | + | 
+-@003B45@—-+ +--------------- + 
~----------~-~----- ‘FROM MCS: ----- MERGE - 
ae : IN PROGRESS PLEASE WAIT (171)-—- 
+ + +) na 
+-@003B47@-+  +------ ~------- + 
perenne nn nn----FROM"MCS: ----- MERGE OK (126)--- 
“+ + + | + 
+ | + + + 
+-@003B1Aa-+ poeeeann nnn -- === + 


CU anne. CED ae “Ee Se ap eo el 1 wae ee oe oe ae 


10 This message is only sent fa format fist as specified,» and formats 
specified in the List are not found in the file. 


B-12 


MX 


APPENDIX 8 (Cont) 


COMMAND 
~------------------ FROM MCS: ---~- NULL DATACOMM MIX----- 
+ + + + 
+ + + + 
+-@000600@-+ 9 t--<----------- + 


SEES ~----FROM MCS: ----~-TASK-~-<mix>--/--<program-name> 
+ + 
+ + 
+-@0000600@-+ 
Sa aE RE ARE REE ER REE QUEUE=<1qn>/<queue-name>---CQ=<1qn>/<queue-name >-- 
+ + 
+ + 
+-ATTI-+ 
-~---MX=<l1sn>/<stat ion-name>-~------------ a a ae a a a en mm 
+ | + 
+ t------- + 
+-ATTO-NO ..STAS=<n>:-STATIONS : -+ + 
+~<1lsn>-+ 
+ + 
+ : + 
fr ennn QUEUE=<1 qn>/< queue —naMe>—— nn rn nnn + 
+ + | + + 
+ + + UF 
+-ATTI-+ | +-ATTO NO. STAS=<n>: ----------- 
+ + 
+ + 
+-<lsn>-+ 
rr EXECUTING--------------~~-----~----------------~--~------- 
+ + 
+ | + 
+-SUSPENDED: -- WAITED ON---QUEUE=<l1qn>/<queue-name>-----~-------~-~----- + 
7 + | + 
+ 3 ; + 
*-OL =<n>-—-O0  =<nSHs3 5S SSeS Se See e eee + 
+ + 
+ + 
+-STATION~<Isn>/<station-name>: SL +<n>-SC <n>-+ 
+ + 
+ | + 
4=MSG (SPACE =a ees s ee So SSeS Se eS + 


Issued 5-14-81 by 
PCN 1106796-001 B-12A 


APPENDIX 8 Ccont) 


The following table defines the items in the externat response for 
the MX command. 


Iten Meaning 
<mix> | Logical task number of the user datacon 
task. _ | 
woncanaesnaues | Prograa name of the user datacom task. 
ATTI. User datacom task is atttached for imput. 
<tqn> | Logical queue number of subnet queue to 


which the user datacom task is attached. 


STATION | User datacom task is suspended on station 
queue Count (SC) = Station queue Limit 
CSL). 

<€isn> | Logical station number of attached station 


where SC = SL. 


<station=name> - NDL defined station name of attached 
3 station where SC = SL. 


SL Station queue Limit. 


$C | Station queue Count. 


Revised 5-14-81 by 7 
PCN 1106796-001 pB-]3 
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APPENDIX B Ccont) 


<queue=name> 
CQ 
MX 


ATTO 


NO.STAS 
<isn> 


<station*name> 


EXECUTING 


QUEUE 


<lqn> 
<queue=name> 


Ot 


NOL defined queue name of subnet queue to 
which user datacom task 18 attached, 


The number and name of this task'*s 
communicate queue. 


The number ani nage of vhe veny station 
assigned to the task. 


User datacom task is attached for output. 


Number of real and dummy stations to 
which datacom user task 118 attached. 


Logical station number of a station to 
which datacom user task is attached. 


NDL defined station name: i+ {2 
alphanumeric characters» of a 

station to which datacom user task is 
attached. 

User datacom task 1s executing. 

User datacom task is suspended, waiting 
for a message to be placed on the subnet 
queue. 7 

Logical queue number (same as above). 


NDL defined queue name (Same aS above). 


User datacon task 15 participating with 
the MCS» and 18s suspended on Qutput Caunt 


(OC) = Dutput Limit COL). 


APPENDIX B Ccont) 


Internal format: 


oS HSS ~<m1x >/<program-name > < status>---------- 
+ + 
+ + 
+-@000600G-+ 


The following table defines the items in the internal response far 
the MX command. 


ites Meaning 
<mix> i byte = logical task Siabee..a ecine user 
datacom task... 
<program=nane 3 i2 tytes program nane of the user 
| datacom tasks. 
<status> i byte - as follows: 
bit 
aFFa Task i$ not tn Te task is not 
aouser datacom task - | 
d°4a Task waiting for soace. 
a? 3a Task waiting for attach. 
aed Task waiting for receive. 
atta Task Gare qag. Oe eeetiale 
duvad Task 15 not waiting. 


2 pytas + Queue reference if task is waiting 
for any reason exc2pt if it is 
walting for soaace. 


Revised 5-14-81 by 
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iten Meaning 
1 byte - Output Limit. 


i byte - Output Count (not currently 
available). 


1 byte ™ Trace Status» as fol lows: 
bit 
7 Trace input msg header. 
6 Trace input text. 
5 Trace input ‘text in hex. 
A Trace output msg header. 
3 Trace output text. | 
2 Trace output text in hex. 
1 Reserved. 
af Reserved. 


1 byte = Transaction Queue (TQ). 
1 byte = Communication Queue (CQ). 


2 bytes @ station nuaber of the dumay MX 
station. ' | 


2 bytes = number of attached stations 


n bytes * attached station <li sn>s: fixed 
format Creal stations only). 


Dwi 
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NT COMMAND 


~----+------------- FROM MCS: -----NT OK (126)--- 
+ + + + 
+ + + + 
+-@000900@-+ +----=--------- + 

NY COMMAND 

~~----------------- FROM MCS: ----- NY OK (126)--- 
+ + + + 
+ + + + 
+-@001500@-+ +-------------- + 


Delayed (Té cf controlling function or moritor statiofis) response: 


---<12-byte station-nameS--------FROM MCS: ------99--9-------- > 
: : 
11 (*) +-@00@«35-byte msg hdr>-+ 


es=LINE-< lin’ NOT ‘READY (216) p=S=-s=s—<S=-=s-sSse=>- wenn 
+ | " 
+ | 7 a 
+-STATION <lsn>/<station-names----NOT READY (215) seer r------- + 


atte eens OES whey AA SO SN ER ED apt) OS SE mmm Ae ee a ee Oe 


, . mat response ta sontrotling function. Issued 5-14-81 by 
ii Internal format response | PCN 1106796-001 


B-16A 


APPENDIX B (cont) 


OL COMMAND Coescription or count ) 

The response consists of one message group» containing one or more 
messages. If there is only one» it has ENKOYE=3. Tf more are present» 
only the last has ENDKEY=3» the others have ENDKEY=2e. 


<lLine-descr iption> external format: 
0 peewee --------- FROM MCS: ~--LINE---<11n>:-~-ADDR=<1 ine-address$--> 
| : | 2 


+ + | . 
-+-@001300a-+ 


~--~TYPE=<hex-type>---MAX ENT=<max entries>--MAX STA=<max stations>---> 


+ + + | + 
_+-MODEM=<lmn>-+ +-STATIONS:----+ + 
| +-<lIsn> <0 ee CA GY SED CD CED SD Mone SND cum eID Ome Game can GD EEE au GEN me Ge? ea ee + 


The following table defines the items in the external response for 
<lLinesdescript ion>-. 


Ites | Meaning 
“etias | Logical line nuamter. 
<lineaddress> Physical fine address. 
| <hex~type> 4 hexadecimal dicits of tine type. 


See figure Bl. | 


<maxmentries> : Maximum number of stations that can be 
attached to this line simultaneousty: 17100. 


APPENDIX B Ccont) 


<waxe-stations> 


<lmn> 
STATIONS 


<i sn> 


Meaning 


Numcer of stations currently attached to this 
lines 0-400. | 


Logical modem nuter. 
Stations attached to this Line. 


Logical station rumber. 


<linesdescription> internat format: 


tealaeenttanententantenteatententmetantan ~--<lin><line-description><directory-byte><line-stations>-- 


+-@001300e@-+ 


The following tabte defines the items in the internal response for 


<line-description>. 
ite 


<tin> 


<line-descr ipttion> 


<directory tyte> 


<line-stations> 


B-i8- 


Meaning 
2 bytes = logical tine number; 0°49. 


7 bytes ~ results of Line-description 
communtcate. 


~ 


l1 byte ~ as follcws: 


avla~- tine in directory. 
a09_a - Line rot in directory. 


n bytes 7 results of Line-stattons commu <- 


cate. 


APPENDIX 


éstation=description> external format: 
—— Saas e= Fis MCS: ---STATION <lsn>/<station-nameS--~& 
+ | + | | 
+-@001300e-+ 
----LINE=<11n>----- TERM=<1 tn>----MODEM=<1mn>--------- SSeeatetataiee ant 
, : é | + + | : : : 
+ + 
+-MUO-+ 
26 ND a GD AP GED SD SU GEES GND GND UD CRD CUED SED GED GENE GD GD NY SAD SED SN GUS AD GND GED SED SUED GO SER UND Can OND WME GOOD SEND OND GE SND GERD OD GED GND OUD OD EES GND GOS OED COND MED CED MND GED uD GuD a SD ENE > 
+ + + + + + + + + | : + 
+ + + + + + + + + oe 
+-MUI+ +-SSB-+ +-FNI-+ +-ROU-+ +-END=€end-character>-+ 
Se TPE See eg Ne ET eg eg ae ene Ep es ae saw a a eee ee Cee en ne een we meee eee 
+ + + + a 
+ + + + 
+-DEL=<line-delete-character>-+ +-BSP=<backspace-characterS-+ 
te eb OD Ome oe ee AD en om oe Rb ND EID GED A RD CED AOD ENP GUND ED GED WATS ONES MND EE OE ND OD GN OD OD GED GED AD SED AD GND GED OO ED GD GRD SES GEN GED. GHD GAD OE GR OED GD OED OED GD OS aD OD OD OD = an a 
+ + + + 
+ + + + 
+-WRU=<wru-character>-+ +-CON=<¢control-character>-+ 
Sa a aa a TYPE=<type S----=----- > 
bp + a ; a 
+ + 
+-ADR=----- (<string><string>) -+ 
+ 
+ + 
$----- “¢strina>------- + 
~--SPEED-<speed>------- se SS eG =a a 
+ + + +. + + 
+ + + 7 + 
+-SPO-+ +-LGN-+ +-WRP-+ 
tn nnn nnn nnn neo RETRY=<n>--- 3 
+ + + + 
+ + + + 
+-WIDTH=<integer>-+ +-PAGE=<integer>-+ 
ea a ahaa QL=cn>---QC=<n> <a SL =k“ SC HEN 
o + , + + os 
+ | | + + A 
+-MCSI-IL=<n>-IC=<¢np-----+ +-MCSO=+ 
a a a —~ 
+ + +- + : 
+ + + + 


Terr eogeue ee tane a tieueeneneses +-ATTO-+ 


) eee SED UO SEED DANE ERS SEDANS CAPD AON MND SD . 


eet cere ne eae am ene Sh ED a OD OSD SD OD OU OE ES CAE CI ND CRY SED IE ED SD SER AERA SSE ENDS GS SD ED LEDS SEWED EDS 


+ + 

+ _ + 

+—-TASK=<mnix>-~/—-~<(program~naMme > 
+ + 
+ + 
+-WAITED-+ 


B (cont) 


Revised 5-14-81 by 
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APPENDIX B Ccont) 


The following table defines the items in the external response for 
<stationdescriotion>. 


Item | | Meaning 
<isn> | Logical station number. 


<station<-name> NDL defined station name: t= {2 
: alphanumeric characters. 


<i tin> 7 Logicat tine numnter of the Line to which this 
station is attached: 255 if not attached, 


<itn> | Logical terminal number of the NDL terminal 
description referenced by this station. 


<tan> | Logical modem number. 

MUD My Use Output. 

MUI. | | . My Use Input. 

$S8 _ Second Stop Bit. 

ENT | Enable input. 

ROB . | Route output bit. 
<€end-chr> 2 = digit hexadecimal end character. 
<lineedet chr > 2 = digit hexadecimal line delete eparaeter: 
<backspace-chr> 2 ~- digit nexadecimal Cackspace character, 
<wru~chr> 2 = digit enadeniwal WRU (Who aRe you) 

| character. 
<control-chr> 2 = digit hexadecimal control character. 


<frequency> | Potting frequency: 09-2553 for every value 
| over 1 causes an addittonalt one second 
delay tetween polls. 


B~20 


APPENDIX 8 Ccont) 


Iten Meaning 
ADR | Address (within the terninal)d. 
(<string><string>) Two alphanumeric strings» densting the 


recetve transmit addresses (within the 
terminal). 


<string> One alphanumeric character denoting the 
receive=transmit address (within the 
terminral). 


<type> & - hexadecimal digits of station TYPE. 
See figure Bri. | 


€speed> 4 ~ h2xadecimal digits of station SPEED. 
See figqure B-2. : 


at MCS DATA BIT 15. 

LGN | MCS DATA 81T 14. 

WRP | MCS DATA SIT 13. 

WIDTH Station's line width. 

PAGE Station's page size. 

aLvac | Queue Limit/Queue Count for sutnet queue to. 


which this station 1s routed. 


MCST | MCS participates cn Input. 

IL/IC Input Limit/Input Count for this station. 
MCSO | MCS participates cn Output. 

SL/SC Statian queue Limit/Station queue count for 


‘ 


this station. 
ATTI 7 Attached for Input to ¢ user datacom task. 


<i qn> |  Logicat sutnet caueue number of queue through 
which this statton is attached. | 


APPENJTX 98 (cont) 


<queue“nene> NOL defined queue name: 1-12 alphanumeric 
characters of queue through which this 
statian 1s attached. 


ATTO Attached for Output to a user datacom task. 


<mMix> Mix number of user datacom task to which this 
station is attached. 


<projram*name> Program name: 1°12 alohanumer'ic characters 
of user datacom task to which this station 
1S attached. 


If a dumay station MXn 1s specified and 1s assoctated with a task» an 
MX response is inctuded. | | 


¢ 


<statton-description> internal format: 


 +-@001300e- 


The following tatle defines the items in the internal response for 
<statione-description>. 


Iten Meaning 


<tsn> 2 bytes = tlogicel station numoer. 


<station=descripttoan> 45 tytes = Results of station-description 
| communtcate. 


If a dummy station MXn is specified» and is associated with a task» 
an MA response is included. | | 


ss Gal a 


APPENDIX B (cont) 


<queuecdescripttion> externat format: 


| paeenoce--~-----PROM MCS: QUEUE-<1qn>-/-<¢queue-name>-QL=<n>-QC=<n>-—2> 


---NO.STAS MAX=-<integer>-~-STATIONS 3 wre reer rrr rere ae 
| + | + 
tH<lsns se eS at: 
+ | rn 
+ , | + 
+-ATT-----TASK=<mix>-/-<program-name>-—-------- $$ + 
+ + + + 
+ + | +: oe 
+—-ENB-+ +-WAILTED-+ 
~--NO.STAS ATT=<n>---STATIONS : --~~--------------- 
+ + 
+ + 
+-<lsn>--------- + 


Revised 5-14-81 by 
PCN 1106796-001  B=23- 


APPE 


NDIX 8 (cont) 


The following tabte defines the items .in the external response for 


<queuadescription>. — 


<queue-nane> 
QL/QC 


NO.STAS MAX 


<isn> 
ATT 


<mix> 
<program-name> 


NO.STAS ATT 


STATIONS 


<ilsn> 


wt ies Cee wee we ste 


Logical queue nemter: 07255» based on 


the atphabetical ordering of the subnet queue 


Name Se 


The NL defined sutnet queue name: 1-12 
alphanumeric characters» of this queue. 


The Queue LimitsQueue Count for this queue, 

The maximum numter of the stations that can 

be attached simultaneously to a user datacom 
task as part of this subnet queue. 

Logical station number. 


queue is attached to a user datacom task. 


Mix number of user datacom task to which 
queue 15 attached. 


Program nage of user datacom task to which 
Queue iS attached. 


The number of stations that are currently 
attached to a user datacom task as part of 
this subnet quete. 


List of stations that are currently attached 
to a user dataccm task as part of this subnet 
queue. 


Logical station numter. 


APPENDIX B (cont) 


<queue"description> internal format: 


So eo a a ee eo oe et oe me om ae <lgqn><subnet-description><subnet-stations>--------- 
+ + 
+ + 
+ 


+-@001300e- 


The following tatle defines the items in the internal response for 
<queue"description>. | | | 


Item | _ Meaning 


<i qn> 2 bytes - logicet queue number 


<subnet=description> 14 bytes - result of subnet-description 
communicate. 


<subnet=st ations> n bytes ~ result of subnet-stations 
| communicate. 


APPENDIX 8 Ccont) 


<UCP cescription> externat format: 


aniniiannRereTaanaiee FROM MCS:<DCP lpn>---PROGRAM COUNT =<n>---------7--7--> 
+ + | 
+ + 
+-@001300@-+ 
~- ce Coes GAD Se eRe CRE GUD SHE RUS GENE SLE ERE GEE MeN GOON ROKK? MENED GEUD GUN ORONO MEE MOS SND OUR) COIS GOD) COE ORE GS MES Gre GUN EEE GumD SEER ome RD MA MO Gee NS eonle OEY cee Gene GD emt cues ae OR oe ONE eee CO come 
~-~PROGRAMS=+ | | + 
+~-<program-—name>: ~NO. TERMINALS=<n>----- 9 nnn ent 
+ | + 
+ {—-—=— + 
+-TERMENALS-+ + 


+=—-<lLtn>~+ 


As tnere are no OCPs on the #80» this forsat does not apply. Instead» 
the MCS responds with an appropriate messzge. 


The following table defines the items in the external response for 


<DCP~descripti on>. : 
item - Meaning 
DCP | Datacom Processore 
<lpn>  Logicat processor numter. 
PROGRAM CJUNT The numter of program files declared for 


this <tpn> tn ADL.- 

PROGRAMS List of the program file names Cand 
associated terminals) dectared for this 
€lon> in NOL. 


<orogram7*name> NOL defined program file name. 


NO.TERMINALS Nuaber of terminal types associated with the 
<program*name>. 


TERMINALS | List of NOL defined terminat types 
assoctated with the <program-name>. 


<ttn> Logicat terminzel number of a NDL defined 


terminal type assoctated with the 
<projram=name>. 


ib 7™ 2D 


APPENDIX B (cont) 


<pcP cescription> tnternat format: 


+ + 
+ + 
+@001300@-+ 


--<DCP-program-terminals>---~- 


The following table defines the items in the internal response for 
<DCP description>. | | 


Item | | Meaning ~ 
<tpn> - 2 -rytes - togical processor numcer. 
<OCP"procran=count> 2 oytes = result of DCP-program-count. 


communicate. 


<DCP-descripticon> n bytes - result of DCP-description 
| conmunicate. 


<OCP-procran=terminals> n oytes °- result of DCP-program terminats. 


As there ara no CCPs on the 389» this forwat of the command does not 
apply. Instead» the MCS responds with an appropriate message. 


Saar 
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<terminaledescrintion> external formet: 


~----------------FROM MCS: -TERM—~<1tn3---SYNC- tne nnn je 
+ + + + + + + 
+ + + + + + + + 
+-@001300@-+ +-ASYNC-+ +=-CRC1-+ +-SUM-+ 


+ + 
+ + 


+ + 


ob | 
+ + + a ++ + 
+ +-TR-<integer>-+ +-TA=<int>-+ +-RA=<int?+ 


| oa-PARM=<hex>-- TIMEOUT=<int>--TURNAROUND=<int>--ALCP=<nnnn>----- 


~--LCP=<nnnn>~~RRP=<nnnn>--TRP=<nnnn>--TTP=<nnnn>--MAX INPUT=<int>---- 


“@=BDAPTOR INEO :e=s2se=$<$<3=S67sSs-s3s-+ “CHAR SZ=<int>--SYNC------ ODD-----= 
| + + + + + + + + 
+. + + + > + + + + 
+-BIN1-+ +-XMIT PAR-+ _ _ +-ASYNC-+ +-EVEN-+ 


a------~~-~---------- NO. BUFFERS=<int>-TYPE=<type>-SPEED=<speed>-STPBITS=—---- 
+ | | | 
+ + 
~ +=<RCVE PAR~-+ 
--~<stop-bits> 


+ + + + + | + + . + 
+-“WRP-+ +-SCR-+ +¢-BLK-+ +-WIDTH=<int>-+ +-PAGE=<int>-+ 


TE BED AD Ode CD CN) CE KEek AED GID ME GERD SEND GD GEN GED Ee WED GED GM AED OD ee Ep Gee EEE OnD ene SO RNS ENS ON OO CE) END ORCS CN NY CR Cem Me ERE WD AE MND ke GRD GD GED OAD OES Ma Gi CD GEE MONO OND mae GERD en SED GND Wm eu GuD OND com 


+++ 
+++ 
+ 


+-CR=<hex>-+ +-LF=<hex>- 
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The following table defines the ttems tn the external response for 
<terminat-cescription>. | 


item Feaning 

TERM NOL defined terminal type. 

<itn> Logical terninal numter. 

SYNC Synchronous. 

ASYNC Asynchronous. 

CRCL 

SUM Summed parity. 

009 Odd parity. 

EVEN Even Jarity. 

BCC Block check character. 

cec Cyclic redundancy check. 

CASE Case. shift. 

TRNSP Transoarent. 

NUPL pul Uedup lex. 

ONES BCC ones. 

NOXL No translate. 

HORZ Horizontal. 

VERT Vertical. 

TR TRAcoune: the number of digits to be 
used in the receéeltve transmit trans 
mission numter. 

TA T-AD count: the rumber of characters to 


be used in the transmit address. 


APPENDIX 8 (cont) 


item | “Meaning 


RA R=-AD count: the number of characters to te 
used in the receive address. 


SYNC 2=digit hexadecimal Synchronous character . 


DAR e=digit hexadecimal parity mask Cone bit 
set for each corresponding data brit). 


TIMEOUT The timeout value specified in the NDL 

| programe : 

<int> integer. 

TURNARGUNE The NOL turnaround delay for this terminal. — 
EC? | 4-digit hexadecimal Line Control: Painter. 

RRP  &edigit hexadecimat Receive Request Pointer. 

TRP | padigie hexadecimal Transmit Request Pointer. 
Tt? 4-digit hexadecimal Transtation Table 

| : pointer. 

Mm AX INPUT _ The size» in bytes» of the largest message 


that can be tnput from this terminal. 


ADAPTOP INFO Infornation usec by the datacom firmware 
to condition the hardware. 


BIN Binary le 

XMIT PAR Transnit Parity. 

CHAR $7Z Character Size: 578 bCits. 
SYNC Synchronous. 

ASYNC Asynchronous. 

ODD | Odd Parity. 


pe sg 


FFCV PAR 


APPENDIX & Ccont) 


Fvyen Parity. 


Receive Parity. 


The 


number of détacom cuffers needed to hotd 


a message (header and text) for this 
terminal. | 


4 hexadecimal digits of terminal TYPE. 


Sea 


see 


figur2 B-2. 


4 nexadecimal digits of terninal SPEED. 


figure Bee. 


4 hexadecimal digits of stoo pit information. 


Cone 
cits 


MCS 


MCS 


MCS 


NOL 


NOL 


NOL 


NOL 


NOL 


NOL 


nit per SPEEC.if set» then two stop 
used for ccerresponding speed). | 


DATA BIT 15 - WRAPAROUND. 

DATA BIT 12 - SCREEN. 

DATA BIT 1i - BLCCKED. 

de fined cee einal Wade hs 

defined terminal ere S122. 
defined CARFI AGE RETURN character. 
defined LINE FEED character. 
defined HOME characer. 


defined CLEAR character. 


APPENDIX & Ccont) 


<terminal-descriotion> internal format: 


SSS S= SSeS a ace cas sao <i th><termina -descriptlonS=<932S4+2—s5Sees=s= 
+ + : | | | | 
+ + 
+-@001300@-+ 


The following tattle defines the items in the internal response for 
<terminaledescription>. | 
Itea | | Meaning 
<itn> | 2 bytes - Logical terminal numter. 


<terminal-description> 38 bytes - result of terminal-description 
7 = communicate. | 


B- 32 


APPENDIX Bb C€cont) 


<cmoder=description> external format: 


~--------------- FROM MCS: MODEM-<lmn>-TYPE=<hex>-SPEED=-<nex>------> 
+ + | 
+ + 
+-@001300@-+ 

pe em NOISE DELAY=<integer>----XMIT DELAY=-<hex?----------------" 


The following table defines the items in the external response for 
<modem-descrinptioan>. : 


Item | Meaning 
<imn> Logical modem number. 
TYPE 4 hexadecimal digits of modem TYPE. 
See figure Bl. 
SPEED | 4 hexadecimal digits of modem SPEED. 
See figure B-2. | 
NOISE DELAY NDtL defined noise delay for this modem. 


XMIT DELAY NOL defined transmit detay for this modem. 
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<modern-descriptton> internal format: 


me a en nnn <lmn><modem-description>- rere ree ene aeteaten 
+ + 7 
+ + | 
+-@001300@-+ 


The followine table defines the “Items in the internal response for 
<moden-description>. 


itean | Meaning 
<tan> 2 bytes - togical modem numder. 
<modem="cescription 8 bytes ~ result of modem~descrtption 


communicate. 


APPENDIX 8B Ccont) 


<linescount>(*«12) external format: 


-@001300@-+ 


<line-count internat format: 


-@001300@-+ 


hs nn ae a A com i ae a ae AD eee oe see. <me eee EP ane om <e 


APPENDIX 38 Ccont) 


<stattons*count>(*13) exterratl format: 


FROM MCS: TOTAL STATIONS = <integer>---------- 


+-@001300@- 


€station=count> internat format: 


+ + 
--#=@001300@-+ 


13 <station-count> is a Z-byte fietd containing the numser of stations. 


B= 56 
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<DCP*count>€*14) external format: 


a ee we en a ne en ee ee FROM MCS: TOTAL DCPS = «<integers-------------- 
+ + 

+ | + 

+-@001300@-+ 


<OCP-count> internat format: 


+ + 
+ + 


+-@001300@-+ — 


<queue-count> external fornat: 


(mer eeeeen=- woe -------- FROM MCS: TOTAL QUEUES = <integer>»-----~------~ 
+ eo 


+-@001300e@-+ 


<queue*count> internal fornat: 


[5 
(ween ------------ <subnet—count>---- net e nnn 
+ | ey 
+ + 


+-@001300@-+ 


EE ES GND ED AED GRE dete a OE ND ee AO aute ED CED maT ee ee nee 


14 <OCP-count> is a 2-byte field containirg the number of DCPs. 


15 <subnetrcount> is a 2“byte field containing the numb2r of subnet 
queues. | . | 


APPENDIX B Ccont) 


<terminal -count>(*16) external format: 


sees eaeecasees ewes FROM MCS: TOTAL TERMINALS = <integer srrennr nnn 


+ + 
+ | + 
+-@001300@-+ 


<termineleccunt> internal format: 


+ + | So +. * “as 
+ + 


+-@001300@-+ 


i eh Ae OR 2 eee ee ee ee eee ee ee oem es cae a ate ee 


16 <terninal-count> is a 2-byte field containing the number of terminais. 


Ho 3k 


APPENDIX 8 Ccont) 


<cmodem*count>(«*«17) external format: 


sae er AS FROM MCS: TOTAL MODEMS = <integer>qq rrr rr 
+ + oy . 

+ + 
+-@001300e@-+ 


<nmodem*count> internal fortat: 


+ | + 
+ + 
+-@001300@-+ 


ie wane te et ED we te coe se eam wee ~~ > am en a oS ee 


17 <modem-count> is a 2=byte field contairing the number of modems. 


ge 39 
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OL COMMAND (CSI TENIF) 

The respoonse-consists of one message group» containing one or more 
messages. If there is only one» tt has EXKCEY=3. If there is more 
than one messages only the Last has ENDKEY=3» the others have 
ENDKEY=2. 


<LINE*SITENIF> externat format: 


os 


wo------------------FROM MCS: LINE <lln>: TYPE=<hex-type>MODEM=<1mn>--- 
+ + 


—+-@001300e—+. 


The following table defines the items in the external response for 


LINE. 
Item | Meaning 
eltn> | | Logical tine nucer. 
<hex=type> 4 hexadecimal digits of line type. 
: See figure Aw1e 
<tmn> | | Logical modem number. 


Be49 


APPENDIX 8 Ccont) 


<LINE“SITENIF> internal format: 


oon ---------------- <1 1n><Line-type><lmn> SR we 
+ | 2 
+-@001300@-+ 


The following tatle defines the ttems tn the internal response for 


LINE. 

Iten Meaning 
€ttn> | | 2 bytes - logical line number. 
<tine-type> : 2 tytes ~ tine type. 
<imn> © 1 byte - togical modem number. 


APPENDIX B Ccont) 


<STATION“SITENIF> externat format: 


~----~----------FROM MCS: STATION élsn3$/<¢station-name>--LINE=<11n>-~» 
+ | + | ‘3 
+ + 
+-@0013 00@-+ 
_ ===-TERM=<1 tn>--MODEM=<€1mn>--~--------------------------- ~------> 
| + + + + + + + + 
+ + + + + + + + 
+-MUD-+ +-MUI-+ +-SSB-+ +-ENI-+ 
a ee ee re ne eee END=<end-chr>--DEL=<line-del-chr>--BSP=<€backspace-chr>--=» 
+ + | —_ ee | | : 
+ + | | 
+-ROU-+ 
~---WRU=<wru-chr>--CON=<con-chr>--ADDR=---(<str , str>)----- TYPE=<type>~---- 
. + + | | 
+ + 
aa So Saale lala 5 
alana: SPEED=<speed>~--RETRY=<n 3------- =< --- === 
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The following table defines the items in the externat response for 
STATTON. 


Item | Meaning 
<isn> | Logical station numter. 
<station-rame> NOL defined station name: 1°12 characters. 
<iln> Logical tine nuater. 
<ltn> Logical terminal number of the NOL terminal 


description referenced by this terainal. 


<tmn> Logical modem number. 

Myo | My Use Output. 

MUI My Use Input. - 

$38 7 Second Stop Bit. ; 

ENT | Enable Input. 

ROB Route Output S3it. 

<end-chr> | é-digit hexadecimal end character. 
<Line-del-chr> 2-digit hexadecimat line delete character. 
<backspace=chr> — 2-digit hexadecimat tackspace character. 
<wru-chr> 2-digit hexadecimal wru (Who Are You) 


character. 


<control-chr> 2-digit hexadecimal control character. 


ADR Address (withing the termminal). 
(<str><str>) 2 alphanumeric strings» denoting the 


receive and transmit addresses (within the 
terminal). 
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€str> Receive=transmit address (within the 
terminal). 


<type> 4 hexadecinal digits of station TYPE. 
<speed> & hexadecimal digits of station SPEED. 
<n> Retry count. 


<STATION-SITENIF> Internal format: 


oe Wgsneeceesaeees ~~-<lsn><redefine-station-description>------- <== 
ae | + | | ‘4 
+ : + 


—* +=@001300e-+ 


‘The following table defines the items in the internat response for 
STATION. | 


item Meaning 
<itsnm 2 bytes - logical station 
number e 
<redefinesstation=description> 21 btytes *- used for redefine- 


station communicate. 
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OL COMMAND CStatus) 


<tine-status> external format: 


~--------------- FROM MCS: ~-LINE--<lln>---------------------» 
+ + 
+ + 
+-@001300@-+ 
So Sa Sees = ADDR=~ <1] ine~addresS>- err ren rn nnn nn 
+ + + + 
+ + + + 


+-YBSY-+ +-YQED-+ 


+-LBSY-+ +-WBSY-+ +-LXED+t +-HIGH<+ +-LRDY-+ +-STBY<-+ +-LQED<-+ 


+ + 
+ + 
+-—c f=<mix>/<program-name>---~----— 
+ + 
+ + 
+—-EXC-+ 


The following table defines the items in the external response for. 
<Linesstatus>. , 


Iten Meaning 


<Lin> | Logical fine numter: 9-49. 
<line=address> Shyseeel dane address: 9749. 
YBSY | Auxiliary line Eusy-. 

YQED | Auxiliary line queued. 

LBSY | | Line tusye 

WBSY | Switched busy. 
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item Meaning 
LXED aac eapnaeted: 
HIGH HIGH FATE. 
LEROY | Line ready. 
STBY = Stand. by. 
LQED Line queued. 
<mix> Mix number of controlling function. 
<program” name> Program name of controlling function. 


EXC This task has exclusive control. 
<Ciné-status> internal format: 


ae a ee <11n><line-status><cf>------------------- 


+ + 


+-@00 1300@—+ 


The fotlowing table defines the items in the internal response for 
<fine-status>.. 


Iten ; Meaning 
<tin> — 2 bytes - Logical line number. 
<line=status> > 2 bytes = result of tine=status 


communicate. 
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<cf> 2 tytes = as follows: 


byte ¢ - Mix number of controtling 
function or a@aFFa. 


tyte 1 - as follows: 


cit 
: | 7 =1 if controlling 
function has 
exclusive control. 
K-49 are reserved. 
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€Cstation=status> external format: 


eee ee nee FROM MCS: ~~-STATION-<lsn>-/-<stat ion-name> 


+-@00 1300@-+ 


~--LINE=< 1 ln den nnn nnn nr nn nn nn rn rr rn re nen 
+ + + + + + + + 
+ + + + + + + + 
+~RDY-+ +-ENAI-+ +-ATCH-+ +-QED—-+ 


mm —QL=<n>-—- - QC =< 1 > er nn nnn - SL =< int > -—----- 
+ | + + + _ 
+ + + _+ 


+-MCSI: ~-IC=<integer>--IL=<int>-+ +-MCSO-+ 


ee + 
t-cf =<mix>/<program-name>-------— 
| + +: 
+ + 
| +7 EXC-+ 
+ + 
+ + 
+-ERR-+ 
+ + 
+ + 
+~ATT-+ 
mm SC Lb a a 
+ + + + 
+ + + + 


+-ATTI--QUEUE=<lqn>-/-<queue-name>-+ +-ATTO-+ 


+ + 
+ + 
+-TASK=~<nix>-/—-<program—name> ~~ enn 
+ + 
+ + 
+-WAITED-+ 


APPENDIX B (cont) 
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The fottowing tarle defines 
~—6<€sgtation-statius>. 


<station=name> 
<ttn> 


RDY 


ENATI 


B=48— 


the items in the external response for 


a a cap a> ee 


Logical station numter iced the 
al phatetical Eee of the <station- 
Nam? $> 


NDL defined station name> 1°12 
alphanumeric characters. | 


Logical Line number or 255% station not 
attached. 


Station tis tocicatly ready. 
Station is enabled for tnput. 
Station is attached to a line. 


Station is queued: one or more output 
operations are queued up for: this station. 


Queue Limit/Qveue Count. for sutnet queue to 
which station is routed. 


MCS participates on tnput. 


cf=<nix> 
<program-n2aae> 
EXC 


ERR 

ATT 

ATT 

‘<lan> 
<queue=name> 
\qTO 
TASK=emix> 
<projgran-nane> 


WAITED 


APPZ NDIX 8 Ccont) 


4eaning 
‘Ing ut Linit/Input Count for this Station. 
405 particioates on outodute 


“gtetion queue Limit/station gueue Count for 
this Ss station. 


me cana of contrattling furction. 
Program name of the controlling function. 
Contralting function has exclusive cantrol. 


Controlting function request alt error 
MESSAGE Se 


soneeetting function reguests attach/detach 
messages. 


Station attached to a user datacon er for 
inputs — 


3 Logical qgueue number of the sutnet queue 
— through which this Station is attached. 


NDE defined name of the subnet queue ~ 
eeran which this station is puter os 


Seatisa attached to aouser datacon task for 
output. 


Logical mix numter of the user datacon task 
to which this station is attached. | 


Froaram name of the user datacom task 
to which this station is attached. 


“The user datacom task to whith this station 
is attached is suspended» waiting or SO=SL. 


lf a duany station is specified» Xn» and it is associated with a 


task,» an MX ressonse 


1s 


included. 
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€station*status> internal format: 


-—---— --------<1sn><stat ion-status> trace-status><priority-class>---- 
; ree : . aa a pce 

+ + 

+~@00 1300@-+ 
----~----<rout ing st atus><cf>——----—-———-nnnnnnnn nnn nn nnn 


The following table defines. he items in the internal response for 
<station-=- status>. | ie 


Item eam | : Meaning . 
-<élsn> maa = 2 bytes - Logical: Station numb ef. 
éseationeseavus> | 6 bytes = a as fol Lows: | | 
a _ ~ 
0 - station- status communicate plus 
bit 3. | : 
4 ara if seis sastid ees an, 
| | input» otherwise» subnet queue 
numb er e 
2 input limit. 
3 ~—s input count. 
ho station tinit. 
5 station count. 
<trace-status> 1 byte - as follows: 
byte 
¢ trace. input message headers. 
6 trace fae text. 
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<priority*class> 


<routing status> 


Meaning. 
> trace input text In hex. 
4 | trace output nessage headers. 
3 trace outout peutis 
2 trace outodut text in hex. 
1 trace to disk. 
. monitor protocol control sequences. 


lL byte - priority class of station. 


5 tytes - as follows: 


byte :-* as follows: 
bit 

4 MCS3 = MCS participates on O/P. 
6  ATTI = Station attached to user 


datacom task for I/P. 


5 ENAI = Station enabled to a user 
datacom task for I/P. | 


4 ATTO = Station attached to user 
datacom tast for O/P. 


3 ENAO = Station enabled ts a user 
datacom task for O/P 


ms 


WAITED = The user datacom task to 
which this station 15 
attached is suspended 
waiting for a receive on 
1t's queue. 


1 MCST - MCS participatas on I/P. 
KeSerVede 


ryte 1 = Sutnet svugue this station is 
attached to. 


byte 2 7" Gueue Limit. 


. . Issued 5-14-81 by 
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byte 4 = Mix nuaber 
Station is 


<cf> 


byte ¥ ”™ Mix number 


byte i'* 


4=9 


If a dummy station is specified CHXn) >» and 
task» an MX response is included. 


> APPENDIX B Ccont)> 


of task to which this 
attached or aFFa. 


2 bytes = as follows: 


of controlling 


function or aFFa. 


EXC - 


att = 


<queue-status> external format: 


as follows: 


Controlling function has 
exclusive control. 


Controlling function request 
all error messages. 


Controtling function requests 
all attach/detach messages _ 


Reserved. 


it is associated with a 


. FA ON A SON ND DD ln iP FROM MCS $ QUEUVE-<lqn>- / ~¢queue-name>-QL=en>-0C=en>---—— 
+ : + = 3°. | 
+ + | . 
+-@001300@-+ 
‘ | as 
+ , ee + 
+-ATT--TASK=~<mix>--/-—<program-name>-—---~-----~-----------~----~-~- + 
+ + + + 
+ + +. + 
+~ENB-+ +-WAITED-+ 
; 
+-NO é STAS ATT =<n>--STATIONS § Dem ewe woo aewewawwwee sstmecdeavesaces 
7 — + 
+. + 
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The foULoutng: table defines the items in the external bee penee for 
equcuens talus? | | | 


Item Bae we Meaning 
<lqn> | oe. Logical queue numter? 6-255 denoting the 
| aipharetical ordering of the station 
name>s. 
<station*name> | NOL defined station name: 1-12 alphanumeric 


characterse | 


Qi svac | Queue Limit/Queue Count for this queue. 


ATT | - | Queue attached to a user datacom task. 
<mix> | ‘Lagieat task number of user datacom task to 


which this queue is attached. 


<programename> : Progras name of user datacom task to es 
| _ | this queue is attached. 


WAITED | ee User datacom task to which this queue is 
attached is suspended» waiting for a MesSag: 
to be Placed on this queue. 


NO.STAS ATT ~ _ : Nuaber ‘of stations currently attached to a. 
; user. datacoa task as part of this aRUGue | 


STATIONS ore 7 List of stations that are currently 
| attached to a user datacom task ‘as part 
of this queue. | | 
<isn> 7 -* | Logical station number. 


<station-name> | NOL defined, station name. 


<queue-status> internal format: 


wan annennnnnnna anne <lqn><subnet-status><trace-status>—---— <routing status>---— 
+ + | oa : 
+ 7 + 
+—@00 1300@-+ 

ae <attached count><attached Bab ones teeta cr 


B=-52 


APPENDIX 8 €cont) | 


The following tabte defines the items in the internal response for 
<queue-status>. 


itea | Meaning 
tans a | 2 bytes - inaiest -adeus number . 
<subnet=status> 7 2 bytes - as foltows: 
byte. 
0 Queue Limit 
1 Queue Count 


<trace=status> pS 1 byte = as described under 
- <station=status>. 


€routing status> : 2 bytes = as follows: 
byte ® = <mix> task number of user datacom 
task to which this queuwe is 
attached. 


- byte 1 = as follows: 


bit 
7 - ATT Queue attached to qa user datacoea 
task. | ? 
6 ENB Queue enabled for user datacom 
task. 
5 WAITED ~ user datacom task to which 
this queue is attached is 
suspended» waiting for a 
message to be placed on this 
queue. 
4G Reserved. 
<attached count> 2 bytes = Number Of stations attached to 
this queue. | 
<attached stat ions> | n bytes - list of attached stations. 
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The following 


<eotcPp@=status> externat format: 


~~---+--~---------- FROM MCS: DCP<lpn>----------------------------- 


+ + 
+ + 
+@00 1300@—+ 


Ap SN GLI GRA otal) CA CD CD A CED ED CRD Cay AY CID CNT GED ED NR GARD GU 


+~PROGRAM=<program-name>—+ 


<OCP-status>. 
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<program=name> 


<mix> 
<program-nane> 


EXC 


+ + 
+ + 
+~IDLE~+ 

+- 

fp 

+ 

i a 

+-cf = <mix>/<program-name>--------- 

+ + 

+ + 


Logical processor number of this DCP: 


YY» te 


ALL of the lines on this DCP are logically 
not readye 


The proaqram file name of progfraN 
currently toaded in thts OCP. 


Mix number of controlling function. 


Program name of controtting function. 


Controlling function has exclusive control. 


APPZNDIX B Ccont) 


<DCP-status> internal format: 


+-@00 1300@—+ 


The following table defines the items in the internal response for 
<DCP=-status>. 


iten | : Meaning 
<lpn> 2 bytes - Logical processor number of. 
, DCP. .. ¢ 

<idie status> 2 bytes = count of ready lines on this 
DCP. 

<DCP-programename> i2 bytes = the program file name of 
program. — : 

<c f> 2 bytes - as follows: 


cyte 2 = Mix number of controlling 
function. 


byte 17 as follows: 


bit 

7 “EXC = Controtling function has 
exclusive control. 

6-0 Feserved. 
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P® COMMAND 
~----------------- FROM MCS: -----PR OK (126) ---------------- 
+ + +) + 
+ + + + 
+-@000700@-+ ‘+------------- + 
PRACTICE COMMAND 
------------------ FROM MCS: ----- PRACTICE OK (126) --------- 
+ + + | + | 
+ ++ + 
+-003CO0G—+.. teenmeemnnmnn a= = 
RD COMMAND 
~---------------- FROM MCS: -----RD OK (126) -------------- 
+ oe + 
Pak. er a + 
 -4-@001000@-+ +------------+ 


— READMESSAGESQUEUE COMMAND 


ae eth OEE ee EER Ce ED OR OD oe ee a Ge ID 6 GP ee Oe oe OP oF a en ae 


----@002F00e@<system output message? 


APPENDIX 8 Ccont) | 


RECALL COMMAND 


~--------=----------- FROM MCS: -----RECALL OK (126) ----------- 
+ + + + 
+ + + + 
-+=@002000@-+ +--------------- + 


Nel ayed responses: 


<12-byte station-namep——----FROM MCS 3 were rrr nn mmm nnn nner — 
f + | + 
+ _ | + 
+-@00e@<35-—byte msg hdr>-+ 
wawnn=<STATION. <lsn>/<station-name>—-- ne eee nn enn ne ee > 
a + 
+ : —— 
+-QUEUE <lqn>/<queue-name>-------+ 
-o--- <integer>~-----------MSGS RECALLED (1046) ----eerre nnn 
+ » # + 
+ + 
+---=-NO------ + 
Intermeci ate recalled messages (TQ): 
| | | 19 
18 <l2@-byte station-name>~---*RECALLED FROM---S <lsn>/<station-name>--:--- 
| : + | | + 7 + + 
+ +-Q <lqn>/<queue-name>---+ + 


+-@00@<35-byte msg hdr>~--9-------------------- - 


ae ame ae am sen om a ~D om Seb Che GRP ab + OE ee A aoe ER Oe 


i@ Name cf station whose <lsn> is in the message header. 


19 BSlank-filled Cafter colon) to 48 bytes. 
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RESTORE COMMAND 


~---=-=--- === = FROM MCS: ------RESTORE OK (126)------------- 


+ + + + 
+ + + + 
+~-@0032 IAG-+ Pee + 

RL COMMAND 

pene enn eee --=--=-FROM MCS: .------ RL OK (126)------------------ 
+ + + + 
+ + + | + 
+-@QQQEQO@—+ 9 trem r nmr + 

RO COMMAND 

wan === ----FROM MCS: ----------------------------------- 

+ + + eo + + + 
+ + + | + + + + + 
+-@002700@-+ +--------------+ +-DEBUG-+ +-TMCS-+ 
+ + + + + + 
+ + + + + + 


+-CHECK-+ +-EVLOG-+ +-ERLOG-+ 


~ aa $$ OPTIONS RESET (1075)- 


+-COLOG-+ +-ALLOW-+ +~-ECHO-+ 
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RN CUMMAND 


a a a a FROM MCS: ‘-----<mix>/<prcgram-name> <queue-name> OK (126) - 
+ + + : 
+ + + + 
+@000300@-+ +--------------- + 


SYMBOLIC SCURCE field (DC.ORIGIN) is equal to the dummy station (MXn) 
of the initiated progran. 


RS COMMAND 


wenn nnn nnn ------FROM MCS: -----RS OK (126) -----------= 
+ t+ + =. } 
+ + + + | 
+-@000F00@-+ +----------- ~——=+ 
RUN COMMANC 
~-~--=---------.-- FROM MCS: ----- RUN OK (126) ----------- 
+ + + | + 
+ bt + + 
+-@003D00@-+ 9 +—------------ +. 


APPENDIX B Ccont) 


FY CUMMAND 


ane Basses ----FROM MCS: ----- RY OK (126) ---- 


+ + + + 
+ + + + 
+ 


Deleyed (19 of controlling function cr monitor stations) response: 


<12-byte station name>----FROM MCS: -------- --~++------~- 


+ 
4+ + 
(*) +-@00@<35-byte msg hdr>-+ 


+-STATION <lsn>/<station-name>--READY (212) -+ 


(*) ~ Internal format response to controlting function. 


SEND COMMAND 


------------------- FROM MCS: ----- SEND OK (126)----- 
+ + | 
+ + ; 

—+-@003E00@-+ 


APPENDIX B (cont) 


SET COMMAND 


SS Se Se FROM MCS: --~---------SET OK (126)--------------- 
+ + 
+ + 
+-@00 1ID00@—+ 
S00 COMMAND 
tetenaateetaatentent antennae FROM MCS: ~--------------~--------------------- 
+ + + + + + + + : 
+ + + + + + + + 
+-@002600@-+ +-------------- + +-DEBUG-+ +-TMCS-+ 
+ + + + + + 
+ + + + + + 


+-CHECK-+ +-EVLOG-+ +-ERLOG-+ 


+-COLOG-+ +-ALLOW-+ +-ECHO-+ 
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STATUS COMMAND 


~---@003F00@ PSS ans x<status information>-------> 
SS SSs4Sser"s 2-55 FROM MCS: -----STATUS OK (126) --------- 
+ + + + | 
+ + + + 
+#-Q@Q0O03FO0G@~+ fret rrr ttre + 


STOP COMMAND 


eer enna nen ne naan FROM MCS: -----STOP OK (126)----- 
+ + + + | 
+ + + + | 
+-@004000@-+ +--------------- + 
STOPTEST COMMAND 
ann ween enn nen nnn FROM MCS: -<=-=-=-STOPTEST OK (126) ----- 
+ + - 
+ + 
+-@001900@-+ 
TERMINATE COMMAND 
meen ne --FROM MCS: ----- TERMINATE OK (126) ----- 
+ + + + | 
+ + + + 
+-@002200@-+ +----------- “--+ 
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TEST COMMAND 


one enn nee eee eee nn FROM MCS. 
+. + 
+ - + 
+~-@001 AOO0G=+ 
TO COMMAND 
ss teietntaaeniatabateieaneteteieaeiaan FROM MCS: 
+ + + 
+ + + 
+=@001800@=-+ +------ = - === 


Delayed response: 


--<l2=byte station name>--@00@<35=-byte msg hdr> FROM MCS: 


TRACE COMMAND 


SS SSe SSeS a Sees ae FROM MCS: 
+ + + 
+ + + 
+-@004200@=$+ +n en nnn nnn n= 


APPZ NDIX B Ccont) 


TO OK (126)-=- 
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WMI COMMAND 


WRU COMMAND 


+-@002900@e- 


B-64— 


cont) 


+ + + 
+ 3 +. + | 
Se aeieteteteteteteter + +-CARD READER------------ St etetetatetateeeteteeteered 
| -_ + | 
+ | _ 3 
+-STATION <lsn>/<station-namé>---------— 
-e . . 
+ | | 7 
+-QUEUE <lgn>/<queue-nameprrn nnn nnn 
+ | 
+-TASK <mix>/-<prog-namey --<queue-namert+ . 
+ | + 
+ | a | + 
++-TASK <mix>/< NULL} Hs o<Sse esse eseerseerer 


$$etteteteeeeee st 


Z1iP COMMAND 
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aon --------------- FROM MCS: -----ZIP OK (126)----- 
+ + + + 
+ + + + 
+-@001B00@-+ +------------- + 


Completion notification (79) responses 


---FROM SPO @QOXXXX@ ZIPPED PROGRAM COMPLETE 


CD 


“65 


Bit 


ce ce oe oe ee 
Oo F NM WD FF UY 


NO Fe) xb Nn o>) ~ oe) \O 


jt 


b"06 


Line 
Type 
Special 
Bits 
BDI 


_ TELEX 
STANDBYTRUE 
STANDBYOPT ION 
LOW/HIGHRATE 
RATESELECT 


MODEM 


DISCONNECTONLOC 
LINEPAUSE/ACU 


DIALOUT 
DIALIN 
ASCII/ 


EBCDICSYNC 
ASYNCHRONOUS 
-FULLDUPLEX 


NDL Type Fields 


Station 
Type 
Special 
Bits 
BDI 
TELEX 


Reserved 


Reserved 
Reserved 
Reserved 
MODEM 


Reserved 


Reserved 


Reserved 
Reserved 


ASCII/ 


EBCDICSYNC 
ASYNCHRONOUS 
FULLDUPLEX 


Figure Awl. 


Terminal 
sa 
Special 
Bits 
BDI | 
TELEX 
Reserved 
Reserved 


Reserved 


Reserved’ 


Reserved 
Reserved 
Reserved 


Reserved 


Reserved 


ASCITI/ 


EBCDICSYNC 
ASYNCHRONOUS 
FULLDUPLEX 


NDL Type Fields 


Mode 


type 


Special 

Reserved 
RAserved 
Reserved 
Reserved 


STANDBYOPTION 


_ Reserved 


RATESELECT 
MODEM 
DISCONNECTONLOC 
ANSWERTONENEEDED 
DIALOUT 


~ DIALIN © 


Reserved 


ASYNCHRONOUS ~ 
FULLDUPLEX _ 


OF N W & UTOVNI COO 


Note: 


Baud 


Speed 


9,600 
me 800 
2,400 
1,800 
1,200 

600 


Asynchronous 
~\Baud) 


Reserved 
38,400 
19, 200 


= bits per second 


oye oNeue 
mt? 


Reserved 
Reserved 
Reserved 


Reserved 


Reserved 
Reserved 
Reserved 
Reserved 
9,600 
7,200 
4,800 
3,600 
2,400 
2,000 
1,200 
— 600 


4 - DIGITS: indicates the frequency to be used for 


this station, terminal, or modem. 
speeds are listed above by bit~-position, 
where bit 15 is the most significant 

(left-most) bit of the field. 


Valid 


the bits take on different meanings for synchronous and 


asynchronous speeds. 


Also, for synchronous terminals, 


only one bit indicating the maximum speed ray be set; in 


Figure 


Aw-?2. 


SPEEC 


all other cases, multiple bits may be set. 
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